Ein Verfahren, die Funktionalität, Inhalte und beschreibenden Metadaten einer Bibliothek oder eines Repositoriums über eine dokumentierte Programmierschnittstelle (API) bereitzustellen, sodass externe Systeme Ressourcen automatisiert, wiederholbar und kontrolliert abfragen, abrufen oder manipulieren können.

Prinzip

Eine API stellt einen programmgesteuerten Vertrag dar: strukturierte Anfragen liefern strukturierte Antworten unter definierten Bedingungen (Endpoints, Parameter, Authentifizierung, Ratenbegrenzung) und ermöglichen so stabile Integrationen und automatisierte Wiederverwendung ohne Voll‑Scraping.

Demonstration

Illustratives Beispiel: Ein Discovery‑Dienst sendet authentifizierte API‑Abfragen an ein Repositorium für bibliographische Datensätze zu einem Fachgebiet; das Repositorium liefert JSON‑Datensätze und einen zeitmarkierten Cursor, sodass der Dienst nur geänderte Datensätze synchronisiert und die Provenienz erhält.

Fehlanwendung

Die API als vollständiges Abbild der Sammlung zu interpretieren (zum Beispiel anzunehmen, die API liefere die kompletten Archivobjekte) ist ein semantischer Fehler: Eine API exponiert ein vertraglich definiertes Teilset und eine Repräsentation, nicht unbedingt den gesamten Bestand oder bewahrungswürdige Objekte.

Konsequenz

Bei korrekter Nutzung ermöglichen APIs Interoperabilität, selektive Synchronisierung und planbare Update‑Workflows; sie schaffen jedoch auch Abhängigkeiten von API‑Verträgen, Versionierung und Zugriffsregeln, die Verfügbarkeit und Langzeitintegration beeinflussen.

Umkehrung

Fehlt eine API, ist veraltet, stark limitiert oder bewusst für Bewahrungsinhalte beschränkt, können alternative Zugangsformen (geplante Bulk‑Exporte, vereinbarte Datenübertragungen oder selektives Harvesting) erforderlich werden; eine API ersetzt nicht automatisch Bewahrungsmaßnahmen.

Abgrenzung

Eindeutig innerhalb: dokumentierte REST/GraphQL/OAI‑Endpoints, die strukturierte Metadaten zurückgeben und Abfragen erlauben. Grenzfall: ein maschinenlesbarer Feed ohne Abfrageendpunkte (nützlich, aber keine vollständige API). Eindeutig außerhalb: manuelles Herunterladen einzelner Dateien über eine Weboberfläche oder ad‑hoc HTML‑Scraping ohne dokumentierte Schnittstelle.

Semantische Spannung

Kontrolle ↔ Zugänglichkeit — APIs erlauben dem Anbieter, Repräsentationen, Zugriffsregeln und Änderungsrhythmen zu steuern, während sie externe Integration ermöglichen; dieser Steuerungsbedarf kann Offenheit und Auffindbarkeit einschränken.

Synthese

API‑gestützter Zugriff ist ein programmgesteuerter Vertrag: er ersetzt ad‑hoc‑Abruf durch definierte, automatisierbare Interaktionen, verbessert Stabilität und Interoperabilität, verlagert jedoch die Schwierigkeit auf Vertrags‑ und Policy‑Management.