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

Zusammen mit dem kostenpflichtigen PAIA-Server bietet die VZG den Betrieb eines DAIA-Servers an.

Daneben gibt es testweise unter http://daia.gbv.de einen kostenlosen DAIA-Server, der jedoch nicht weiterentwickelt wird. 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 https://paia.gbv.de/DE-Hil2/daia 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:

https://paia.gbv.de/DE-Luen4/daia?id=ppn:638378788&format=json

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

{
  "document": [{
    "id": "http://uri.gbv.de/document/opac-de-luen4:ppn:638378788",
    "requested": "opac-de-luen4:ppn:638378788",
    "about": "Geschichten, mit denen man rechnen kann [Sekundarstufe I], Heft 2 / Erichson, Christa (2010)",
    "item": [{
      "unavailable": [{
        "service": "openaccess"
      }, {
        "service": "remote"
      }],
      "label": "CAM:FaD 251.009/2",
      "department": {
        "id": "http://uri.gbv.de/organization/isil/DE-Luen4@department-0",
        "content": "Universitätsbibliothek Lüneburg"
      },
      "id": "http://uri.gbv.de/document/opac-de-luen4:bar:LUN4$04107268",
      "available": [{
        "service": "presentation"
      }, {
        "service": "loan"
      }],
      "storage": {
        "id": "http://uri.gbv.de/organization/isil/DE-Luen4@FaD",
        "href": "http://lhlue.gbv.de/php/bibmapredir.php?act=r&lng=DU&sgn=CAM:FaD%205156.018",
        "content": "Lesesaal, Obergeschoss"
      }
    }, {
      "unavailable": [{
        "service": "openaccess"
      }, {
        "service": "remote"
      }],
      "label": "CAM:FaD 251.009/2 a",
      "department": {
        "id": "http://uri.gbv.de/organization/isil/DE-Luen4@department-0",
        "content": "Universitätsbibliothek Lüneburg"
      },
      "id": "http://uri.gbv.de/document/opac-de-luen4:bar:LUN4$06187951",
      "available": [{
        "service": "presentation"
      }, {
        "service": "loan"
      }],
      "storage": {
        "id": "http://uri.gbv.de/organization/isil/DE-Luen4@FaD",
        "href": "http://lhlue.gbv.de/php/bibmapredir.php?act=r&lng=DU&sgn=CAM:FaD%205156.018",
        "content": "Lesesaal, Obergeschoss"
      }
    }]
  }],
  "institution": {
    "id": "http://uri.gbv.de/organization/isil/DE-Luen4"
  },
  "timestamp": "2018-01-23T13:14:42.430+01:00"
}

Zurückgeliefert werden folgende Informationen:

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.

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.

Weitere Informationen

PAIA/DAIA-Mailingliste

  • No labels