SRU
Häufig gestellte Anfragen (FAQ) / Fehlerbehebung
Was passiert bei einem nicht korrekten oder unterstützten
Parameter in der URL-Anfrage?
Was passiert bei einer Anfrage ohne Angabe eines Index?
Was passiert mit Diakritika, Leerzeichen oder dem Zeichen
Slash?
Was passiert bei einer Anfrage für die keine passenden Daten
existieren?
Was passiert bei einer Anfrage über eine nicht autorisierte
IP-Adresse?
Was passiert bei bei leerem Datenshopkonto (keine Einheiten
mehr verfügbar)?
Was passiert bei Abfrage eines kostenpflichtigen
Formates?
Wie erhalte ich einen Zugangscode / access token und wie
formuliere ich eine Anfrage mit access token?
SRU im Überblick
Was passiert bei einem nicht korrekten oder
unterstützten Parameter in der URL-Anfrage?
Die SRU-Schnittstelle liefert dem Standard entsprechend eine
Fehlerdiagnose in XML (diagnostic) zurück.
Beispiel:
Was passiert bei einer Anfrage ohne Angabe eines
Index?
Wird kein Index in der SRU-Anfrage angegeben, wird die Anfrage
an den umfangreichsten Index des ausgewählten Katalogs geleitet
(Fallback).
Was passiert mit Diakritika, Leerzeichen oder dem
Zeichen Slash?
Diese müssen in einer SRU-Anfrage in URL-Kodierung (UTF-8
hexadezimal, auch Prozentkodierung genannt) umgewandelt werden.
Z.B. der Buchstabe ä in %C3%A4, ein Leerzeichen in %20 und
ein Slash in %2F. Suchbegriffe können durch Anführungszeichen
("Suchbegriff") umschlossen werden. Enthält ein Suchbegriff die
Zeichen < > = / ( ) oder Leerzeichen muss dieser durch
Anführungszeichen (z. B. für das Sigel "1w/r" in URL-Kodierung:
"1w%2Fr") umschlossen werden (siehe
Standard).
Was passiert bei einer Anfrage für die keine passenden
Daten existieren?
Die SRU-Schnittstelle liefert "number of records 0"
zurück:
Was passiert bei einer Anfrage über eine nicht
autorisierte IP-Adresse?
Die SRU-Schnittstelle liefert "Not authorized to send
record in this schema / MABxml-1-plus. No Account for
IpAddress: XXX.XXX.XXX.XXX " zurück:
Was passiert bei bei leerem Datenshopkonto (keine
Einheiten mehr verfügbar)?
Sie SRU-Schnittstelle liefert "Not authorized to send
record in this schema / MABxml-1. Payment Required" zurück:
Was passiert bei Abfrage eines kostenpflichtigen
Formates?
Die SRU-Schnittstelle liefert "Not authorized to send record in
this schema / MABxml-1-plus. No Rights for Catalog: dnb and
Format: MABxml-1-plus" zurück:
Nach Registrierung und Freischaltung erhalten Sie unter "Mein Konto / Zugangsdaten" Zugriff auf den Menüpunkt "Zugangsverwaltung Schnittstellen". Dort können Sie den Zugangscode / access token erzeugen und verwalten.
Zwei Möglichkeiten der Einbindung des access token werden akzeptiert:
1. Angabe in der Basis-URL mit dem Trennzeichen ~ (Tilde)
http://services.d-nb.de/sru/accessToken~XxXxXxXxXxXxXxXxXxXx/dnb?version=1.1&operation=searchRetrieve&query=%22Deutsche%20Nationalbibliothek%22
2. Parameter / Wert innerhalb der Anfrage
http://services.d-nb.de/sru/dnb?version=1.1&operation=searchRetrieve&query=%22Deutsche%20Nationalbibliothek%22&accessToken=XxXxXxXxXxXxXxXxXxXx
SRU-Service
