Cette API permet de recevoir les métadonnées complètes des publications modifiées depuis la dernière synchronisation (complète ou différentielle) ou une date spécifique. Elle sert à effectuer des mises à jour régulières.
Si le nombre de modifications apportées aux publications est trop grand (code HTTP 400), il faut utiliser l’API de synchronisation complète du catalogue.
Elle retourne le premier fichier de métadonnées. Pour accéder aux fichiers suivants, il faut suivre l’URL indiqué dans le champ Link de l’en-tête de réponse HTTP jusqu’à obtenir un code HTTP “404 Not Found”.
Déclaration
Adresse : /api/organisations/[organisation_id]/publications/delta[.format]
Formats : onix, xml
Méthode : GET
Sécurité : HTTP/BASIC (Nom d'utilisateur et mot de passe)
Paramètres
organisation_id (Obligatoire)
Numéro d'organisation fourni à l'inscription.
format (Optionnel)
Format des fichiers, onix ou xml. La valeur par défaut est onix.
from (Optionnel)
Date et heure, au format ISO 8601 Basic. Si paramètre absent : retourne les métadonnées des publications modifiées depuis la dernière synchronisation complète ou différentielle. Si paramètre présent : retourne les métadonnées des publications modifiées depuis cette date et heure.
Attention : la date passée doit être égale ou antérieure à la date de début de la précédente synchronisation (réception de l'appel initial pour la première page de résultats).
Réponses
200 : OK
Le fichier a été créé avec succès. Le champ Link de l’en-tête de réponse HTTP contient un URL (Link: ; rel=next) permettant d’accéder au fichier suivant. On arrive à la fin de la liste des fichiers lorsqu’on obtient un code HTTP “404 Not Found”.
400 : too_many_results
Le nombre de modifications est trop important. Utiliser plutôt l’API de synchronisation complète du catalogue.
401 : access_denied
Accès refusé à la ressource.
404 : not_found
L'organisation n'a pu être trouvée ou il n’y a pas eu de modifications depuis la dernière synchronisation.
415 : invalid_format
Le format demandé n'est pas pris en charge.