OAI-Dienst

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 2020 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-03-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 Mehrteilern) geliefert. Andere Formatvarianten sind nur über die API-Dienste erhältlich.

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

http://oai.dff.film/?verb=ListIdentifiers&set=Agent&metadataPrefix=eac_beta&from=2022-03-20T01:00:00&until=2022-03-24T00:00:00

Hinweis: Normdatensätze des OAI-Sets "Agent" umfassen Personen wie auch Körperschaften. Eine sparate Abfrage ist hier nicht möglich.

Ein einzelner Agent-Datensatz:

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

Hinweis: Für Agent-Datensätze wird ausschließlich das XML-Schema eac_beta verwendet. Andere Angaben im metadataPrefix haben keinen Effekt.