Journées ABES 2014 - 21 mai 2014 - Session "Des API, pour quoi faire ?" - Aurélien Charot, Thomas Michaux - ABES : Présentation des différentes API et web services proposés par l'ABES. Pour bien comprendre la stratégie API pour une meilleure valorisation des données et diversification des services offerts
1. Des API : pour quoi faire ?
Aurélien Charot
Thomas Michaux
Journées ABES 2014Mercredi 21 Mai : 8h30 - 9h30
2. 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
3. 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
4. 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
5. 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
6. 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