Seitenhierarchie
Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Was ist DAIA?

Die Document Availability Information API (DAIA) ist eine auf HTTP und JSON basierende Schnittstelle um aktuellen Verfügbarkeitsinformationen zu Dokumenten in Bibliotheken und ähnlichen Einrichtungen abzufragen. DAIA ist unter <http://purl.org/NET/DAIA> spezifiziert und in verschiedenen Servern und Clients implementiert.

Angebot der Verbundzentrale

Die VZG bietet testweise unter http://daia.gbv.de einen eigenen DAIA-Server für verschiedene PICA-Datenbanken an. Grundsätzlich ist es möglich, die aktuelle Verfügbarkeit von Dokumenten in einzelnen lokalen Bibliothekssystemen (LBS) abzufragen. Da der DAIA-Server für jedes Bibliothekssystemen konfiguriert werden muss, werden derzeit nicht alle Systeme unterstützt und die Verfügbarkeitsinformationen können unterschiedlich detailliert ausfallen.

Verwendung

Sie erreichen den Service unter daia.gbv.de. Für einzelne Kataloge gibt es zusätzlich eigene Basis-URLs auf Grundlage der ISIL. So ist beispielsweise die DAIA-Schnittstelle für den Katalog der Universitätsbibliothek Hildesheim unter <http://daia.gbv.de/isil/DE-Hil2> erreichbar.

Zur Abfrage der Verfügbarkeit eines Dokumentes ist der URL-Parameter id notwendig. Dokumente werden grundsätzlich durch die Auswahl einer Datenbank, einen Identifier-Typ und eine lokale Dokument-ID innerhalb dieser Datenbank identifiziert. Der bevorzugte Identifier-Typ ist ppn.

Beispielabfrage

Die aktuelle Verfügbarkeit des Dokument mit der PPN 638378788 Katalog der Universitätsbibliothek Lüneburg (ISIL DE-Luen4) kannüber folgende URL abgefragt werden:

http://daia.gbv.de/isil/DE-Luen4?id=ppn:638378788&format=json>

Der Katalog hat den Datenbankschlüssel opac-de-luen4, so dass ebenso die URL <http://daia.gbv.de/?id=opac-de-luen4:ppn:638378788&format=json> verwendet werden kann. Die Antwort in DAIA/JSON sieht etwa folgendermaßen aus:

{
   "timestamp" : "2015-09-28T08:16:36Z",
   "institution" : {
      "href" : "http://www.leuphana.de/bibliothek.html",
      "content" : "Universitätsbibliothek Lüneburg",
      "id" : "http://uri.gbv.de/organization/isil/DE-Luen4"
   },
   "document" : [
      {
         "href" : "http://lhlue.gbv.de/DB=1/PPNSET?PPN=638378788",
         "item" : [
            {
               "department" : {
                  "href" : "http://www.leuphana.de/bibliothek.html",
                  "content" : "Universitätsbibliothek Lüneburg",
                  "id" : "http://uri.gbv.de/organization/isil/DE-Luen4"
               },
               "href" : "http://lhlue.gbv.de/DB=1/PPNSET?PPN=638378788",
               "label" : "FaD 251.009/2",
               "id" : "http://uri.gbv.de/document/opac-de-luen4:epn:1193596645",
               "available" : [
                  { "service" : "presentation" },
                  { "service" : "loan" },
                  { "service" : "interloan" }
               ]
            },
            {
               "department" : {
                  "href" : "http://www.leuphana.de/bibliothek.html",
                  "content" : "Universitätsbibliothek Lüneburg",
                  "id" : "http://uri.gbv.de/organization/isil/DE-Luen4"
               },
               "href" : "http://lhlue.gbv.de/DB=1/PPNSET?PPN=638378788",
               "label" : "FaD 251.009/2 a",
               "id" : "http://uri.gbv.de/document/opac-de-luen4:epn:1193596653",
               "available" : [
                  { "service" : "presentation" },
                  { "service" : "loan" },
                  { "service" : "interloan" }
               ]
            }
         ],
         "id" : "http://uri.gbv.de/document/opac-de-luen4:ppn:638378788"
      }
   ]
}

Zurückgeliefert werden folgende Informationen:

  • Die Institution, welche abgefragt wurde (Universitätsbibliothek Lüneburg)
  • Ein passendes Dokument (<http://uri.gbv.de/document/opac-de-luen4:ppn:638378788>)
  • Zwei Exemplare
    • Ein Exemplar mit der Signatur "FaD 251.009/" befindet sich am Standard-Standort der Universitätsbibliothek Lüneburg. Es ist derzeit ausleihbar (available service="loan"), vor Ort einsehbar und kann in die Fernleihe gegeben werden.
    • Ein Exemplar mit der Signatur "FaD 251.009/2" befindet sich am Institut für Mathematik. Es ist derzeit nicht ausleihbar oder fernleihbar ({"service":"loan"}), kann aber vor Ort eingesehen werden ({"service":"presentation"}). Da keine Wartezeit angegeben ist, ist davon auszugehen, dass das Exemplar auch in Zukunft nicht ausleihbar und somit ein Präzenexemplar ist.

Alle Objekte (Dokumente, Exemplare, Institutionen, Standorte...) sind einer URI identifiziert ("id":"..."). Per Linked Open Data lassen sich darüber bei Bedarf zusätzliche Informationen abrufen, z.B. bibliographische Angaben zum Dokument oder Adressdaten und Geokoorinaten von Standorten.

Datenbanken

Im Wesentlichen werden die unter http://unapi.gbv.de/about aufgeführten Datenbanken unterstützt, wobei die Vollständigkeit und Korrektheit je nach Konfiguration der Datenbank unterschiedlich ausfallen kann. Auch andere Identifier-Typen als ppn werden nur für einige Datenbanken unterstützt.

Formate

Das primäre Datenformat zur Kodierung von Verfügbarkeitsinformationen entsprechend des DAIA-Datenmodells ist JSON. Prinzipiell lassen sich die gleichen Informationen aber auch verlustfrei in andere Formate konvertieren, darunter XML (format=xml) und RDF (format=turtle u.A.), diese Formate müssen jedoch nicht von allen DAIA-Servern unterstützt werden. Um Unklarheiten zu vermeiden, sollte immer der Abfrage-Parameter format mitgeschicket werden, also format=json.

Siehe auch: DAIA-Validator zur Konvertierung verschiedener DAIA-Formate

Konfiguration

Die DAIA-Schnittstelle basiert unter Anderem auf Daten aus dem jeweiligen Lokalsystem einer Bibliothek. Die Bibliothek muss deshalb wie unter Konfiguration der GBV-DAIA-Server beschrieben die notwendigen Informationen zur Konfiguration ihrer DAIA-Schnittstelle bereitstellen und aktualisieren.

Sofern Sie Anregungen und Fehler haben, teilen Sie uns diese Bitte mit einer konkreten Dokument-ID und dem erwarteten Ergebnis mit.


Diese Seite wurde zuletzt am 29. September 2015 um 14:05 Uhr geändert.

  • Keine Stichwörter