| Table of Contents |
|---|
...
| Info |
|---|
IBOO met à disposition de ses utilisateurs la possibilité d’importer ses données par une API. La description et l’utilisation de cette API (parmi d’autres) est disponible dans de nombreux langages via notre notre documentation Postman. Postman permet l’utilisation de toutes les requêtes fournies si vous voulez créez votre propre espace (Voir le bouton “Run in Postman“ en haut à droite). |
Import via l’IHM
Lors d’un import manuel par l’IHM, l’opérateur doit fournir un fichier contenant l’offre à importer sous la forme d’un fichier ZIP tel qu’il est défini dans le chapitre B 1 Organisation des imports. Dans le cas de l'import Offre Théorique, le ZIP ne pourra contenir qu’une seule offre.
API RESTful pour les SI Fournisseurs
Cette API permet en particulier d’alimenter les espaces de travail via des opérations d’imports automatisés (ces espaces de travail vont contenir les jeux de données).
...
Cet identifiant est accessible en même temps que les clés d’accès API comme ci-dessous.
...
Protocole
Les requêtes utilisent les différentes méthodes HTTP :
...
Exemple : http://mon_domaine/{mes_ressources} : la partie {mes_ressources} nécessite de renseigner une chaîne non vide.
Sécurité
L’authentification est réalisée en utilisant une “basic authentification” comme définit par la RFC2617. L’appelant doit utiliser :
...
curl --basic --user organisation-code:bae26d4c1a358c7fdaf7b5e1277e5219
Import
Un import se caractérise par :
Attribut | Description |
id | Identifiant unique appelé aussi ‘code import’ |
name | Nom de l’import |
status | Statut de l’import :
|
referential_ids | Identifiants des jeux de données transporteur |
Créer un import :
Méthode http
...
name: nom de l’import [obligatoire]
file: fichier à importer [obligatoire]
notification_target: la destination des notifications à la fin de l’import
valeurs :
workbenchtous les utilisateurs de l’espace de travail reçoivent une notificationnonepas de notification envoyée (défaut)
options:
automatic_merge: booléen permettant de définir si la finalisation s’effectue automatiquement après un import réussi.
archive_on_fail : booléen permettant de définir si l’import a échoué d’archiver le jeu de données créé
merge_method : chaîne de caractère permettant de définir quelle finalisation utiliser :
legacy : finalisation historique
experimental : finalisation V2 contenant de nombreuses optimisations
Pour soumettre des attributs dans form-data il faut utiliser la syntaxe workbench_import[attribute name], par exemple workbench_import[name].
...