Manuel BACON

2.2. Le webservice package2kbart

Le webservice package2kbart permet de remonter l’ensemble des lignes d’un fichier KBART donné.

Requête :

https://bacon.abes.fr/package2kbart/[Nom_du_package ]

Paramètres :

Le paramètre à passer est le nom du package, qui peut par exemple être récupéré grâce au webservice « List ».

Ex : https://bacon.abes.fr/package2kbart/NPG_FRANCE_ISTEXJOURNALS_2015-05-13

Option « dernière version du package » :

Si vous souhaitez obtenir systématiquement la dernière version du package sans avoir à faire évoluer la requête, il suffit de renseigner le paramètre [Nom_du_package] sans la date.

Ex : https://bacon.abes.fr/package2kbart/NPG_FRANCE_ISTEXJOURNALS

Réponse par défaut :

Par défaut la réponse est le téléchargement d’un fichier correspondant aux recommandations KBART, soit un fichier txt dont les séparateurs sont des tabulations. Si vous souhaitez utiliser le mécanisme de négociation de contenu, votre requête doit contenir dans son en-tête HTTP_ACCEPT text/tab-separated-values.

Réponse XML

Il est possible d’obtenir une réponse dans le format XML en ajoutant à la fin de l’URL de base .xml . Toutes les balises incluses dans la balise <element> correspondent aux intitulés de la recommandation KBART. 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/xml ou text/xml.

Ex : https://bacon.abes.fr/package2kbart/NPG_FRANCE_ISTEXJOURNALS_2015-05-13.xml

<bacon>

<query>

<package>NPG_FRANCE_ISTEXJOURNALS_2015-05-13</package>

<kbart>

<element>

<publication_title>Nature</publication_title>

<print_identifier>0028-0836</print_identifier>

<online_identifier>1476-4687</online_identifier>

<date_first_issue_online>1869</date_first_issue_online>

<num_first_vol_online>1</num_first_vol_online>

<num_first_issue_online>1</num_first_issue_online>

<date_last_issue_online>2012</date_last_issue_online>

<num_last_vol_online>492</num_last_vol_online>

<num_last_issue_online>7429</num_last_issue_online>

<title_url> http://www.nature.com/nature </title_url>

<first_author/>

<title_id>nature</title_id>

<embargo_info/>

<coverage_depth>fulltext</coverage_depth>

<notes/>

<publisher_name>Nature</publisher_name>

<publication_type>serial</publication_type>

<date_monograph_published_print/>

<date_monograph_published_online/>

<monograph_volume/>

<monograph_edition/>

<first_editor/>

<parent_publication_title_id/>

<preceding_publication_title_id/>

<access_type>P</access_type>

</element>

...

</kbart>

</query>

</bacon>

Réponse JSON

Il est possible d’obtenir une réponse dans le format JSON en ajoutant à la fin de l’URL de base .json . Tous les ensembles de paires nom/valeur inclus dans l’objet « element » correspondent aux intitulés de la recommandation KBART. 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.

Ex : https://bacon.abes.fr/package2kbart/NPG_FRANCE_ISTEXJOURNALS_2015-05-13.json

{

"bacon":{

"query":{

"package":"NPG_FRANCE_ISTEXJOURNALS_2015-05-13","kbart":[

{

"element":{

"publication_title":"Nature",

"print_identifier":"0028-0836",

"online_identifier":"1476-4687",

"date_first_issue_online":1869,

"num_first_vol_online":1,

"num_first_issue_online":1,

"date_last_issue_online":2012,

"num_last_vol_online":492,

"num_last_issue_online":7429,

"title_url":"http://www.nature.com/nature",

"first_author":null,

"title_id":"nature",

"embargo_info":null,

"coverage_depth":"fulltext",

"notes":null,

"publisher_name":"Nature",

"publication_type":"serial",

"date_monograph_published_print":null,

"date_monograph_published_online":null,

"monograph_volume":null,

"monograph_edition":null,

"first_editor":null,

"parent_publication_title_id":null,

"preceding_publication_title_id":null,

"access_type":"P"

}

},

]

}

}

}