Journées ABES 2014 - Des APIs pour quoi faire ?

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