Une gamme de web services pour renforcer l’interopérabilité des données
Afin de renforcer l’interopérabilité des données et optimiser leur réutilisation par les systèmes d’information des établissements de l’ESR, l’Abes met à la disposition des professionnels des bibliothèques et des développeurs informatiques de l’ESR une gamme de solutions techniques et de web services.
Certains de ces web services font l’objet d’une documentation au format openAPI sur api.gouv.fr (https://api.gouv.fr/producteurs/abes).
BACON, base de connaissance nationale
Web services BACON
- list : renvoie la liste des bouquets disponibles
- package2kbart : renvoie la liste des titres d’un bouquet
- id2kbart : permet de savoir à quel(s) bouquet(s) appartient un document en fonction de son identifiant
en savoir plus : consulter la documentation
Exposition des données BACON
en savoir plus : consulter les modalités de réutilisation
Calames, catalogue des archives et manuscrits
Web services Calames
- permet la récupération de fragments EAD
- permet la récupération des points d’accès entre Calames et IdRef
en savoir plus : consulter la documentation
Exposition des données Calames
en savoir plus : consulter les modalités de réutilisation
IdRef, identifiants et référentiels pour l’ESR
Web services : identifiants de bibliothèques RCR et ISIL
à noter : l’Abes est agence nationale d’attribution de l’ISIL, identifiant international dédié aux bibliothèques
- Iln2rcr : renvoie la liste des n°RCR utilisant un même Système de Gestion de Bibliothèque (n°ILN)
- rcr2iln : renvoie les n°ILN de rattachement associés à une liste de n°RCR
- listisil : établit la liste des établissements disposant d’un n°ISIL. Le fichier comporte : n°RCR / n°ISIL / intitulé court de l’établissement
- listrcr : établit les correspondances entre les n° RCR et les intitulés des établissements Sudoc / Sudoc PS. Le fichier comporte : n°RCR / n°ILN de rattachement / intitulé court / n°PPN de la notice
Web services IdRef
Les web services IdRef permettent de récupérer des données à l’unité. Ils peuvent être associés les uns aux autres pour construire des services complexes. Certains sont indispensables pour gérer les mises à jour et garantir la synchronisation d’une base tierce avec IdRef.
- biblio : renvoie la liste des ressources bibliographiques Sudoc liées à une notice d’autorité
- idref2id : fournit les identifiants d’une dizaine d’autres systèmes (à spécifier dans la requête) à partir d’un identifiant IdRef
- id2idref : fournit un identifiant IdRef à partir d’identifiants d’autres systèmes (à spécifier dans la requête)
- iln2Td3 : renvoie la liste des propositions Rameau (Td3) en cours dans chaque ILN
- merged : renvoie l’identifiant d’une notice valide à partir de l’identifiant d’une notice devenue obsolète suite à fusion
- merged inversé : indique l’identifiant d’une notice devenue obsolète à partir de l’identifiant d’une notice valide, suite à une fusion
- references : renvoie la liste des ressources bibliographiques signalées dans différentes sources de données (HAL, Persée…) et liées à une notice d’autorité IdRef
en savoir plus : consulter la documentation
API SolR : interroger IdRef
IdRef s’appuie sur un moteur de recherche SolR dont les index sont interrogeables par API. Ainsi, les données IdRef sont interrogeables et récupérables de manière transparente, y compris à partir d’une interface tierce.
en savoir plus : consulter la documentation
Intégrer IdRef dans une application tierce
Développé initialement pour permettre les interactions avec les applications STAR et Calames, IdRef peut communiquer avec tout autre site web et être appelé depuis une application tierce. Le code JavaScript de cette interconnexion est librement récupérable.
en savoir plus : consulter la documentation
Réutiliser les données d’autorité IdRef
en savoir plus : consulter les modalités de réutilisation
Sudoc, catalogue des bibliothèques de l’ESR
Web services Sudoc
à noter : la liste des web services Sudoc est disponible à partir d’un fichier dynamique (annuaire.xls) mis à jour en temps réel.
- biblio : renvoie la liste des ressources bibliographiques Sudoc liées à une notice d’autorité
- bibliocontrol : à partir du RCR créateur de la notice, renvoie, sous forme de fichier, la liste des PPN créés présentant une anomalie
- frbn2ppn / ocn2ppn / dnb2ppn / ucatb2ppn / frcairninfo2ppn : renvoient un identifiant de notice Sudoc (n°PPN) à partir d’un identifiant de notice issue d’une autre base
- isbn2ppn / ean2ppn / issn2ppn : renvoient les identifiants de notice Sudoc (n°PPN) à partir d’identifiants normalisés (ISBN, EAN, ISSN)
- merged : renvoie l’identifiant d’une notice valide à partir de l’identifiant d’une notice obsolète suite à fusion de notices
- métarevues : génère l’historique complet d’une revue – imprimée et/ou électronique – à partir d’un identifiant notice Sudoc (n°PPN)
- multiwhere : liste les bibliothèques du réseau Sudoc possédant un même document
- nnt2ppn : renvoie un identifiant de notice Sudoc (n°PPN) à partir du Numéro National de Thèses (NNT)
- ppn2nnt : renvoie le Numéro National de Thèses (NNT) à partir d’un identifiant de notice Sudoc (n°PPN)
- unimarc2marcxml : à partir de leur n°PPN, les notices Sudoc en UNIMARC sont renvoyées au format MarcXML
- marcXml2tei : à partir de son n°PPN, une notice de mémoire ou travail universitaire (hors thèses de doctorat) est renvoyée au format xml-tei
- ppn2epn : renvoie le numéro d’exemplaire (EPN) lié à un RCR à partir d’un ou de plusieurs PPN
en savoir plus : consulter la documentation
Exposition des données Sudoc
en savoir plus : consulter les modalités de réutilisation
API WorldCat
Les API WorldCat permettent d’enrichir les catalogues des bibliothèques en y intégrant des données et fonctionnalités de Worldcat. L’utilisation des API WorldCat est réservé aux établissements adhérents.
Pour en bénéficier, les directeurs des établissements Sudoc sont invités à déposer une simple demande auprès d’OCLC.
- en savoir plus : consulter le site WordCat / rubrique « Web services for developers »
theses.fr / STAR / STEP : métadonnées des thèses de doctorat
Importer des données
- web service SOAP et/ou service mail utilisé pour les imports STEP / STAR
en savoir plus : consulter la documentation
Interroger theses.fr
Il existe trois API permettant d’utiliser les données de theses.fr.
- « Interroger les données de theses.fr » permet de lancer une recherche dans les données de theses.fr décrivant les thèses et les personnes liées aux thèses. Les données sont récupérables au format JSON.
- « Export des données de theses.fr » permet d’exporter les métadonnées descriptives d’une thèse soutenue ou d’une thèse en préparation aux formats XML ou RDF ainsi que la référence bibliographique d’une thèse soutenue ou d’une thèse en préparation aux formats RIS et BibTeX.
- « Diffusion des fichiers de thèses sur theses.fr » gère la diffusion des fichiers de thèses, en accès libre ou en accès restreint, sur theses.fr, ainsi que les boutons d’accès.
Réutiliser les métadonnées de thèses (soutenues et en préparation)
- consulter les modalités de réutilisation
Ressources associées
- Pour toute demande d’assistance : guichet ABESstp