Le webservice list⚓
Le webservice list renvoie l'ensemble des fichiers présents dans BACON. Il donne une vue exhaustive du contenu de la Base de connaissance nationale.
Deux formats d'exports sont disponibles :
le format .xml
le format .json
Exemple -
Il peut être appelé pour vérifier si des bouquets ont été créés ou mis à jour.
Requête⚓
Exemple - Réponse XML⚓
<bacon>
<query>
<id>list</id>
<results>
<element>
<package_id>BRILL_FRANCE_ISTEXJOURNALS_2015-04-23</package_id>
<provider>BRILL</provider>
<display_name>Brill</display_name>
<package>FRANCE_ISTEXJOURNALS</package>
<date>2015-04-23</date>
<label>N</label>
<type>serial</type>
</element>
<element>
<package_id>IOP_FRANCE_ISTEXJOURNALS_2015-05-13</package_id>
<provider>IOP</provider>
<display_name>Institute of Physics Publishing</display_name>
<package>FRANCE_ISTEXJOURNALS</package>
<date>2015-05-13</date>
<label>N</label>
<type>serial</type>
</element>
<element>
<package_id>NPG_FRANCE_ISTEXJOURNALS_2015-05-13</package_id>
<provider>NPG</provider>
<display_name>Springer Nature</display_name>
<package>FRANCE_ISTEXJOURNALS</package>
<date>2015-05-13</date>
<label>N</label>
<type>serial</type>
</element>
</results>
</query>
</bacon>
Structure de l'information
La balise
<package_id>contient le nom complet du fichier KBART, dont la structure suit la recommandation. Les balises<provider>,<package>,<date>sont le résultat du découpage du nom complet en trois blocs permettant d'identifier respectivement le fournisseur, le nom du fichier et la date de publication.La balise
<display_name>affiche le nom du fournisseur tel qu'il apparaît sur le site internet (page "Exporter") et explicite, le cas échéant, la balise<provider>La balise
<label>précise si les données ont été, ou non, labellisées* par l'Abes (2 valeurs : Y/N)La balise
<type>indique le type de ressource que contient le fichier. Il peut s'agir de périodiques (<type>serial</type>), de monographies (<type>monograph</type>) ou d'un mélange des deux (<type>mixed</type>)
Exemple - Réponse JSON⚓
Il est possible d'obtenir une réponse dans le format JSON en ajoutant ".json" à la fin de l'URL de base : https://bacon.abes.fr/list.json
Si vous souhaitez utiliser le mécanisme de négociation de contenu, votre requête doit contenir dans son en-tête : HTTP_ACCEPT application/json ou text/json
{"bacon":{"query":{"id":"list",
"results":[
{"element":{"package_id":"BRILL_FRANCE_ISTEXJOURNALS_2015-04-23",
"provider":"BRILL",
"display_name":"Brill",
"package":"FRANCE_ISTEXJOURNALS",
"date":"2015-04-23",
"label":"N",
"type":"serial"
}
},
{"element":{"package_id":"IOP_FRANCE_ISTEXJOURNALS_2015-05-13",
"provider":"IOP",
"display_name":"Institute of Physics publishing",
"package":"FRANCE_ISTEXJOURNALS",
"date":"2015-05-13",
"label":"N",
"type":"serial"
}
},
{"element":{"package_id":"NPG_FRANCE_ISTEXJOURNALS_2015-05-13",
"provider":"NPG",
"display_name":"Springer Nature",
"package":"FRANCE_ISTEXJOURNALS",
"date":"2015-05-13",
"label":"N",
"type":"serial"
}
}
]
}
}
}