Une méthode qui expose, via une interface de programmation documentée (API), les fonctions d’un service documentaire ou d’un dépôt, son contenu et ses métadonnées descriptives afin que des systèmes externes puissent interroger, récupérer ou manipuler des ressources de façon automatisée, répétable et contrôlée.

Principe

Une API formalise un contrat programmatique : des requêtes structurées obtiennent des réponses structurées selon des contraintes définies (endpoints, paramètres, authentification, limites de fréquence), permettant une intégration stable et la réutilisation automatisée sans recourir au prélèvement massif de contenus.

Démonstration

Scénario illustratif : un service de découverte effectue des requêtes authentifiées à un endpoint du dépôt pour des notices bibliographiques d’un sujet donné ; le dépôt renvoie des notices JSON et un curseur horodaté, permettant au service d’ingérer uniquement les notices modifiées et de conserver la traçabilité des métadonnées.

Mauvaise application

Considérer qu’une API fournit une copie exhaustive de la collection (par exemple en supposant que l’API délivre l’intégralité des objets d’archivage) est une erreur sémantique : l’API expose un sous‑ensemble et une représentation définis par contrat, pas nécessairement l’intégralité des holdings ou des objets destinés à la préservation.

Conséquence

Bien utilisée, l’API facilite l’interopérabilité, la synchronisation sélective et des flux de mise à jour prévisibles ; elle crée aussi une dépendance opérationnelle vis‑à‑vis du contrat, du versioning et des politiques d’accès du fournisseur, qui influent sur la disponibilité et l’intégration à long terme.

Inversion

Si une API fait défaut, est dépréciée, trop limitée ou restreinte pour le contenu de préservation, d’autres voies (exports massifs planifiés, transferts de données convenus ou moissonnage sélectif) peuvent être nécessaires ; inversement, une API ne remplace pas une stratégie de préservation.

Limite

Dans la définition : endpoints REST/GraphQL/OAI documentés retournant des métadonnées structurées et acceptant des requêtes. Cas limite : un flux Web lisible par machine fourni par l’institution mais sans endpoint de requête (utile mais pas une API complète). Hors définition : téléchargement manuel de fichiers via une interface web ou extraction HTML ad hoc sans interface documentée.

Tension sémantique

Contrôle ↔ Accessibilité — l’API permet au fournisseur de contrôler représentations, règles d’accès et cadence de changements tout en autorisant l’intégration externe ; ce besoin de contrôle peut limiter l’ouverture et la découvrabilité.

Synthèse

L’accès par API est un contrat programmatique : il substitue la récupération ad hoc par des interactions définies et automatisables qui renforcent la stabilité et l’interopérabilité mais déplacent la contrainte vers la gestion des contrats et la dépendance aux politiques du fournisseur.