API Z39.50

API Z39.50

Contexte

L'api Z3950 est un protocole d'interroger des métadonnées défini dans les années 80. A la Bnf, il permet d'interroger le catalogue général qui regroupe la description bibliographique des documents conservés à la bibliothèque. Il permet de faire des requêtes sur certains champs des notices (ISBN, titre) et de récupérer la description bibliographique des documents répondant à ces critères.

Documentation

Page officielle BnF

Page Profil Z3950 BnF

Point d'accès

z3950.bnf.fr:2211 Z3950/Z3950_BNF Pour la nouvelle version (bascule le 21 novembre) z3950labs.bnf.fr:2211 Z3950/Z3950_BNF

Exemple d'utilisation

Recherche titre en Intermarc

C:\Program Files (x86)\YAZ\bin>yaz-client z3950labs.bnf.fr:2211/TOUT-UTF8 -u Z39
50/Z3950_BNF
Authentication set to Open (Z3950/Z3950_BNF)
Connecting...OK.
Sent initrequest.
Connection accepted by v3 target.
ID     : 81
Name   : Metaproxy/YAZ
Version: 1.11.3/5.16.0 e3fd23ffc6ce9cc4d06177cb4c083d27dc69cc26
Options: search present scan namedResultSets
Z> elements F
Z> format Unimarc
Z> find @attr 1=4 "destin "
Sent searchRequest.
Received SearchResponse.
Search was a success.
Number of hits: 6897, setno 1
records returned: 0
Z> show 1+1
Sent presentRequest (1+1).
Records: 1
[TOUT-UTF8]Record type: Unimarc
00808nam  2200217   450
001 FRBNF357460980000009
003 http://catalogue.bnf.fr/ark:/12148/cb357460983
020    $a FR $b 59514357
039    $o OPL $a 019117149
100    $a 19950426d1947    m  y0frey50      ba
101 0  $a fre
102    $a FR
105    $a ||||z   00|a|
106    $a r
200 1  $a Destin $b Texte imprim+® $f Andr+®e Marik
210    $a Paris $c Ed. Pierre de Ronsard $d [1947]
215    $a 44 p. $d 18 cm
686    $a 821 $2 Cadre de classement de la Bibliographie nationale fran+ºaise
700  | $3 11914579 $a Marik $b Andr+®e $f 1914-.... $4 070
801  0 $a FR $b FR-751131015 $c 19950426 $g AFNOR $h FRBNF357460980000009 $2 int
ermrc
930    $5 FR-751131010:35746098001001 $a 16-YE PIECE-3222 $b 759999999 $c Tolbia
c - Rez de Jardin - Litt+®rature et art - Magasin $d O

nextResultSetPosition = 2

Difficultés

Ce n'est pas une interface interrogeable en HTTP, mais à plus bas niveau, en TCP. Il existe des clients, comme yaz qui emplémentent le protocole d'interrogation.

Clients de l'API à la BnF

Index Data fournit yaz, outil d'interrogation :

Il existe des versions pour différents langages java, C++ ...