Des API : pour quoi faire ?
Aurélien Charot
Thomas Michaux
Journées ABES 2014 Mercredi 21 Mai : 8h30 - 9h30
Définitions
• API = Application Programming Interface
Interface de programmation / façade par laquelle un logiciel offre des services à d’autres logiciels
• Service web = Technologie web permettant l’échange et la communication entre applications et systèmes hétérogènes
Journées ABES 2014
Dans quel but ?
• Ouvrir les données du Sudoc*, afin de permettre : – Leur réutilisation dans des systèmes d’information externes, sans
intervention de l’Abes
– Leur exposition sur le web de données (RDF/XML)
– Une interopérabilité entre les applications développées à l’Abes (pas de dépendance logicielle) • Dans l’interface PSI : deeplink et géolocalisation • Dans theses.fr : géolocalisation, merged • Dans IdRef : lien permanent • Dans SelfSudoc : onglet « autres services » • …
* Toutes les données ne peuvent pas être exposées à des traitements automatiques, pour des raisons
juridiques
Journées ABES 2014
De quelle façon ?
• Par des services web de consultation
• Choix de la solution la plus facile à utiliser pour le « client » : – Utilisation du protocole HTTP, et de sa méthode de demande de ressource :
HTTP GET
• Chaque service a une adresse propre, des identifiants de ressource (PPN, ISBN, NNT) et des paramètres (format, options, etc) – Exemples :
• http://www.idref.fr/services/biblio/108850730 • http://www.theses.fr/sujets/?q=titres:essais&type=avancee&format=json • http://www.theses.fr/2009PA030125.rdf • http://www.sudoc.fr/services/multiwhere/144089661
• Chaque service est capable de gérer la négociation de contenu et peut
répondre dans divers formats : HTML, JSON, XML, CSV, RIS, BibTex, etc.
Journées ABES 2014
Liens utiles
Site web de l’Abes :
• http://www.abes.fr/Acces-direct-a/Pour-les-developpeurs Punktokomo, blog technique de l’Abes : • http://punktokomo.abes.fr/2012/02/16/sudoc-idref-de-nouveaux-micro-web-services/ • http://punktokomo.abes.fr/2011/07/04/micro-web-service-biblio-quels-sont-les-documents-
rattaches-a-cette-personne/ • http://punktokomo.abes.fr/2013/10/07/quelques-cles-pour-geolocaliser-les-notices-sudoc/ • http://punktokomo.abes.fr/2014/02/18/domybiblio/ • http://punktokomo.abes.fr/2011/07/22/theses-fr-lapi-xml-de-recherche/ Documentation des API Sudoc et Theses.fr : • http://documentation.abes.fr/sudoc/manuels/administration/aidewebservices/index.html • http://documentation.abes.fr/aidethesesfr/accueil/ch03.html
Annuaire de l’API Sudoc : • www.sudoc.fr/services/annuaire/
Demande d’évolutions / corrections : • https://stp.abes.fr
Journées ABES 2014
Utilisation des API par des établissements du réseau
• Au SCD Paris Sud, par Yves Tomic
• Au SCD Rennes 2, par Julien Sicot
• Questions / réponses
Journées ABES 2014