List Web Service⚓

The list web service returns all files present in BACON, providing a comprehensive overview of the National Knowledge Base content.

Two export formats are available:

  • XML

  • JSON

ExempleExample⚓

This service can be used to verify whether packages have been created or updated.

ExempleXML response⚓

1
<bacon>
2
<query>
3
<id>list</id>
4
<results>
5
<element>
6
<package_id>BRILL_FRANCE_ISTEXJOURNALS_2015-04-23</package_id>
7
<provider>BRILL</provider>
8
<display_name>Brill</display_name>
9
<package>FRANCE_ISTEXJOURNALS</package>
10
<date>2015-04-23</date>
11
<label>N</label>
12
<type>serial</type>
13
</element> 
14
<element>
15
<package_id>IOP_FRANCE_ISTEXJOURNALS_2015-05-13</package_id>
16
<provider>IOP</provider>
17
<display_name>Institute of Physics Publishing</display_name>
18
<package>FRANCE_ISTEXJOURNALS</package>
19
<date>2015-05-13</date>
20
<label>N</label>
21
<type>serial</type>
22
</element>
23
<element>
24
<package_id>NPG_FRANCE_ISTEXJOURNALS_2015-05-13</package_id>
25
<provider>NPG</provider>
26
<display_name>Springer Nature</display_name>
27
<package>FRANCE_ISTEXJOURNALS</package>
28
<date>2015-05-13</date>
29
<label>N</label>
30
<type>serial</type>
31
</element>
32
</results>
33
</query>
34
</bacon>

Structure

  • The<package_id> tag contains the full name of the KBART file, structured according to the KBART standards. The <provider>, <package>, <date> tags are parsed from the full filename by dividing it into three segments, which respectively identify the provider, the package name, and the date of publication.

  • The <display_name> tag displays the provider’s name as shown on the website (Export page) and serves to clarify the <provider> tag when needed

  • The <label> tag indicates whether the data has been certified* by Abes or not (two values: Y/N)

  • The <type> tag specifies the type of resource contained in the file, which may be journals (<type>serial</type>), monographs (<type>monograph</type>) or a mix of both (<type>mixed</type>)

ExempleJSON response⚓

A JSON response can be obtained by appending .json to the base URL : https://bacon.abes.fr/list.json

To use content negotiation, your request must include the following in the header : HTTP_ACCEPT application/json ou text/json

1
{"bacon":
2
3
{"query":
4
5
{"id":
6
7
"list",
8
9
"results":[
10
11
{"element":{
12
13
"package_id":"BRILL_FRANCE_ISTEXJOURNALS_2015-04-23",
14
15
"provider":"BRILL",
16
17
"display_name":"Brill",
18
19
"package":"FRANCE_ISTEXJOURNALS",
20
21
"date":"2015-04-23",
22
23
"label":"N",
24
25
"type":"serial"
26
27
}
28
29
},
30
31
{"element":{
32
33
"package_id":"IOP_FRANCE_ISTEXJOURNALS_2015-05-13",
34
35
"provider":"IOP",
36
37
"display_name":"Institute of Physics publishing",
38
39
"package":"FRANCE_ISTEXJOURNALS",
40
41
"date":"2015-05-13",
42
43
"label":"N",
44
45
"type":"serial"
46
47
}
48
49
},
50
51
{"element":{
52
53
"package_id":"NPG_FRANCE_ISTEXJOURNALS_2015-05-13",
54
55
"provider":"NPG",
56
57
"display_name":"Springer Nature",
58
59
"package":"FRANCE_ISTEXJOURNALS",
60
61
"date":"2015-05-13",
62
63
"label":"N",
64
65
"type":"serial"
66
67
}
68
69
}
70
71
]
72
73
}
74
75
}
76
77
}