OAI-Dienst

Aus DIF Filmographie Wiki
Wechseln zu: Navigation, Suche

Der OAI-Dienst des DFF ermöglicht es Kooperationspartnern, Änderungen am Datenbestand der ZDB tagesaktuell oder über bestimmte Zeitspannen zu verfolgen und in eigenen Anwendungsprogrammen nachzuführen. Dieser Dienst implementiert dazu die OAI-PMH-Spezifikation. Zugangspunkt für alle angebotenen Datensets ist http://oai.dff.film.

Die Nutzung des OAI-Dienstes ist derzeit nur aus bestimmten, vom DFF nach Vereinbarung freigegebenen IP-Adressräumen möglich.

Bestand

Eine Liste der verfügbaren Datensets ist mit ListSets zu erhalten; die angebotenen Datenformate sind unter ListMetadataFormats gelistet.

Der Datenset Agent enthält nur jene Datensätze der Entitäten Person und Körperschaft, die seit Oktober 2021 neu angelegt oder geändert wurden, während FilmWork den Gesamtbestand der Entität Filmwerk umfasst.

Überwachung

Die Aktualisierung des OAI-Bestandes kann über die StatusDB-Seite OAI-Datenprovider des DFF kontrolliert werden.

Beispiele

Identifikatoren aller Filmwerks-Datensätze, die vom 19. bis 23. März 2022 neu aufgenommen oder geändert wurden:

http://oai.dff.film/?verb=ListIdentifiers&set=FilmWork&metadataPrefix=dif_fw&from=2022-03-20T00:00:00&until=2022-02-23T23:59:59

Hinweis: Die Aktualisierung des OAI-Dienstes erfolgt nur einmal täglich um 00:15h mit den Änderungen und Neuaufnahmen des Vortags. Eine Zeitangabe wie from=2022-03-20T00:00:00 schließt damit alle Änderungen vom 19.3.2022 ein.

Ein einzelner Filmwerks-Datensatz:

http://oai.dff.film/?verb=GetRecord&metadataPrefix=dif_fw&identifier=oai:deutsches-filminstitut.de:de-dif_zf-fw_C9D6376D158B420581D26955546FB557

Hinweis: Filmwerks-Datensätze werden hier stets in der XML-Schema-Version 1.5 (d.h. mit einem Element "Aggregatwerk" für Teile von Reihen und Mehrteiler) geliefert. Andere Formatvarianten sind nur über die API-Dienste erhältlich.