abes-esr / abes-webservices

Espace destiné à recenser et suivre les idées, besoins, fonctionnalités, bug concernant les web services de l'Abes

abes-webservices

Espace destiné à recenser et suivre les idées, besoins, fonctionnalités, bug concernant les web services de l'Abes. Voir l'espace "Issues" qui est dédié à cela (nécessite un compte github pour déposer ou commenter une issue).

Ce dépôt github n'accueille pas les codes sources des webservices de l'Abes dans leurs versions actuelles car cela nécessiterait un gros travail de nettoyage. L'ouverture des codes sources des webservice Abes sera réalisée à l'occasion d'une future refonte.

Documentation des Web services

La liste des web services de l'Abes est disponible sur le site institutionnel ici : https://abes.fr/api-et-web-services/

• La documentation développeur des API du Sudoc : http://documentation.abes.fr/sudoc/manuels/administration/aidewebservices/
• La documentation développeur des API d'IdRef : http://documentation.abes.fr/aideidrefdeveloppeur/
• La documentation développeur des API de BACON : http://documentation.abes.fr/aidebacon/index.html#webservices
• La documentation développeur des API de Calames : http://documentation.abes.fr/aidecalames/manuelinformaticien/index.html#webservices

Les descriptions OpenAPI avec espaces démo des web services de l'Abes sont disponibles ici : https://api.gouv.fr/producteurs/abes

• API Sudoc : https://api.gouv.fr/les-api/api-sudoc
• API IdRef : https://api.gouv.fr/les-api/api-idref

Copie d'écran de l'espace démo OpenAPI des API du Sudoc :

abes-webservices's Issues

WS Merged : retour d'un seul PPN et non de plusieurs

Actuellement, le WebService Merged est susceptible de renvoyer plusieurs PPN pour peu qu'il y ait eu des fusions en "cascade" : A fusionné au profit de B, puis B fusionné au profit de C : l''interrogation sur A renvoie alors : C --PPN actif-- PUIS B --PPN fusionné--.

exemple : https://www.sudoc.fr/services/merged/020250223&format=text/json

Cela génère donc un "array" JSON, là où on attend du WS un object simple -1 seul réponse (le ppn actuellement actif).

https://stp.abes.fr/node/60793/edit?origine=sudocpro
https://twitter.com/27point7/status/1147026797109940227

Création WS correspondance RCR-ILN-intitulé court

Hello,
Je prends mon ticket dans la queue pour création de microwebservices !
L'idée : économiser la mise à jour manuelle du fichier mis à dispo sur le site web de l'ABES
Source : table lib_profile
Champs : RCR, ILN, intitulé / avec filtres sur les RCR "techniques" qui n'ont pas vocation à être exposés
Sorties : XML, Excel, Json
Et quand ? quand on peut. C'est pas pressé.

Merci !

Service PPN vers DOI ?

Bonjour,

Différents webservices existent de type ppn2id ou id2ppn mais je n'ai trouvé aucun moyen d'associer le ppn d'une publication à son DOI.

Par exemple le PPN 197396968 renvoie à Qu'est-ce que l'accès ouvert, ouvrage doté du DOI 10.4000/books.oep.1600
Malheureusement ce DOI ne figure pas sur la notice ni au format HTML, ni RDF ni MarcXML

Cette absence me fait m'interroger : Est-ce seulement possible ? Il me semblait pourtant que le DOI était consigné en zone 017 des notices du SUDOC.

Y aurait-il une méthode alternative pour arriver à ce résultat ? J'ai cherché du côté d'IdRef mais sans succès.

Si c'est impossible, il me semble que ce serait une piste à creuser pour développer vos webservices.

Création d'un webservice de suggestion d'indice dewey

Bonjour,

il pourrait être intéressant que l'abes propose un web service similaire à ce que propose déjà l'OCLC via son service Classify et le web service associé ou encore le service Ez(re)Classification conçu par l'université Catholique de Lille.

L'idée serait d'avoir un micro service léger qui prendrait en paramètre un PPN d'une notice bibliographique, d'une autorité personne ou encore sujet et qui donnerait en résultat une liste de classes dewey, suggérées en fonction de leur fréquence d'utilisation dans les notices liées (exemplarisation sudoc par les établissements du réseau en 930 par exemple).

D'avance merci pour l'attention que vous accorderez à cette requête.

Julien Sicot - université Rennes 2

Création WS PPN-Nb Exemplaires

Bonjour,

Ca serait bien, à partir d'un ou de plusieurs PPN, d'obtenir en sortie :

-le nombre d'exemplaires
-les RCR:EPN concernés
(liste non exhaustive, on peut sans doute y ajouter des infos "uniques" comme localisation, cote, code Peb et/ou l'ensemble de l' "exemplaire.xml"
A voir comment faire!
Plein de cas d'usages différents en fonction de ce qu'on obtient en sortie (poldoc, politique de PEB, conservation, etc.)
Ce qui est certain, c'est qu'il manque actuellement un WS de granularité "intermédiaire" pour les exemplaires, même s'il est toujours possible de parser les PPN.xml pour les compter, les extraire, etc.)

API Solr IdRef - Problème avec recordtype_z:r (Rameau)

Bonjour,

Auparavant il était possible d'utiliser le champ subjectheading_t pour faire des recherches dans les notices Rameau (recordtype_z:r) mais aujourd'hui ce n'est plus possible.

Ex: https://www.idref.fr/Sru/Solr?wt=json&indent=on&q=recordtype_z:r%20AND%20subjectheading_t:bibliotheques
Ne retourne aucun résultat

Les premiers résultats de https://www.idref.fr/Sru/Solr?wt=json&indent=on&q=recordtype_z:r sont des notices de regroupement

Inconsistance de la clé sudoc.query.result sur le web service iln2rcr

La structure JSON de retour est inconsistante dans le cas où on obtient en retour un unique RCR ou plusieurs RCR.

Exemple de JSON retourné avec plusieurs RCR : https://www.idref.fr/services/iln2rcr/4&format=text/json

{
  "sudoc": {
    "query": {
      "iln": 4,
      "result": [
        {
          "library": {
            "rcr": "040702201",
            "name": "Université d'Aix-Marseille",
            "shortname": "AIX-MARSEILLE1-IUT Digne",
            "address": "Rue Pasteur 04000 Digne-les-bains FR",
            "web": "http://gsite.univ-provence.fr/",
            "type": "Bibliothèque d'institut ou de département universitaire",
            "latitude": 44.091451,
            "longitude": 6.227104
          }
        },

Exemple de JSON retourné avec un seul RCR : https://www.idref.fr/services/iln2rcr/9&format=text/json

{
  "sudoc": {
    "query": {
      "iln": 9,
      "result": {
        "library": {
          "rcr": "973022101",
          "name": "Université de Guyane",
          "shortname": "CAYENNE-BU",
          "address": "Campus de Troubiran, 2091 route de Baduel 97349 Cayenne GF",
          "web": "https://www.univ-guyane.fr/campus/bibliotheque/",
          "type": "Bibliothèque universitaire",
          "latitude": 4.9227,
          "longitude": -52.32689999999999
        }
      }
    }
  }
}

L'inconsistance est située sur la clé sudoc.query.result qui dans le premier cas contient un tableau de RCR et dans le second cas contient directement la structure du RCR.

Pour que les programmes utilisant ce web service n'aient pas besoin de parcourir la réponse JSON de deux façon différentes, il serait attendu que la clé sudoc.query.result contienne comme valeur systématiquement un tableau, même dans le cas où un unique RCR est retourné.

Ce comportement est observé sur plusieurs web service et on retrouve l'inconsistance dans le cas où le web service merged retourne 1 ou plusieurs PPN

L'équipe Abes travaillant sur l'application ITEM a observé ce comportement et a adapté ses programme pour gérer les deux cas.