Table of Contents |
---|
...
Les jeux de données importés seront restreints à une période calendaire maximale autorisée à compter du jour de l’import (actuellement fixée à 1 ans). Les calendriers sortants de cette période seront tronqués et s’ils se réduisent à aucun jour valide, ils ne seront pas importés, de même que les objets de l’offre qui leur sont strictement rattachées (courses, missions, itinéraires).
De même, un début de période inférieur à la date T du jour sera tronqué au-delà d’une limite d’un nombre de jours (ce seuil sera fixé par Ile-de-France Mobilités). Une alerte simplifiée précisera la réduction du jeu de donnée à l’import.
Si au final, aucune donnée n’est importée, le jeu de données sera rejeté.
Les données importées sont regroupées dans un fichier ZIP, la taille de celui-ci ne devra pas excéder 80Mo.
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 :
...
name: nom de l’import [obligatoire]
file: fichier à importer [obligatoire]
notification_target: la destination des notifications à la fin de l’import
valeurs :
workbench
tous les utilisateurs de l’espace de travail reçoivent une notificationnone
pas 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.
...