Direkt zum Hauptinhalt

Objekt API

Die Objekte API bietet direkten Zugriff auf die detaillierten Metadaten und Mediendateien einzelner Kulturgüter im Kulturpool. Sie liefert strukturierte Daten im Europeana Data Model (EDM) als JSON-LD sowie eine aufbereitete Liste aller zugehörigen Medien.

Basis-URL

https://api.kulturpool.at/object

Endpunkte

Einzelnes Objekt abrufen

GET /object/

Ruft detaillierte Informationen zu einem spezifischen Objekt anhand seiner eindeutigen Kennung ab.

Parameter

Parameter Typ Beschreibung Beispiel
institution string Die Kennung der Institution albertina
version string Die Version (Zeitpunkt der Datenübernahme) 2025-04-08T09:05:19.201Z
identifier string Die eindeutige ID des Objekts 22385v

Beispiel-URL

https://api.kulturpool.at/object/?institution=albertina&version=2025-04-08T09:05:19.201Z&identifier=22385v

Antwort

Die Antwort der API besteht aus zwei Hauptteilen: metadata und media.

  • Das metadata-Objekt enthält die reichhaltigen beschreibenden Daten des Kulturguts. Es wird im Format JSON-LD (eine RDF-Serialisierung) ausgeliefert und folgt dem Europeana Data Model (EDM). Diese Struktur zeigt die Daten so, wie sie im Kulturpool verarbeitet und an die Europeana weitergegeben werden, und ermöglicht so eine maximale Interoperabilität.

  • Das media-Objekt ist ein JSON-Array, das alle mit dem Objekt verknüpften externen Mediendateien auflistet. Jeder Eintrag im Array enthält eine url, einen type und den content_type (MIME-Typ) der Datei. Dies ermöglicht eine einfache und schnelle Integration der visuellen oder auditiven Repräsentationen des Objekts in eigene Anwendungen.

{
  "metadata": {
    "@context": {
      "ore": "http://www.openarchives.org/ore/terms/",
      "edm": "http://www.europeana.eu/schemas/edm/",
      "dc": "http://purl.org/dc/elements/1.1/",
      "...": "..."
    },
    "id": "#tms_40502_AGG",
    "type": "Aggregation",
    "aggregatedCHO": {
      "id": "#tms_40502",
      "type": "ProvidedCHO",
      "dc:title": [
        {
          "lang": "de",
          "value": "Die bezauberte Mühle"
        }
      ]
    },
    "...": "..."
  },
  "media": [
    {
      "url": "https://sammlungenonline.albertina.at/iiif/tms_40502/manifest.json",
      "type": "iiif",
      "content_type": "application/json"
    },
    {
      "url": "https://sammlungenonline.albertina.at/cc/image-proxy/tms_40502/0/image.jpg",
      "type": "image",
      "content_type": "image/jpeg"
    }
  ]
}

Datenstruktur

Hauptobjekt

Feld Typ Beschreibung
metadata object Ein JSON-LD-Objekt mit den Metadaten gemäß dem Europeana Data Model.
media Media[] Ein Array von Media-Objekten, die alle zugehörigen Dateien repräsentieren.

Media

Feld Typ Beschreibung
url string Die direkte URL zur Mediendatei oder zum IIIF-Manifest.
type string Der Typ der Mediendatei. Mögliche Werte: iiif, image, video, audio, 3d, pdf, embed, other.
content_type string Der MIME-Typ der Ressource (z.B. application/json, image/jpeg).

Verbindung zur Suche API

In den Ergebnissen der Suche API finden Sie für jedes Objekt das Feld fullViewMetadata. Der Wert dieses Feldes ist der exakte Pfad (z.B. /object/?institution=...&version=...&identifier=...), der direkt zum entsprechenden Eintrag in der Objekte API führt. Dies erleichtert das Abrufen der vollständigen Objekt-Details nach einer Suche.

Fehlerbehandlung

404 - Objekt nicht gefunden

Wird zurückgegeben, wenn keine Kombination aus institution, version und identifier gefunden wurde.

{
  "detail": "Error fetching data from upstream API"
}

500 - Server-Fehler

Wird bei unerwarteten Fehlern auf dem Server zurückgegeben.

{
  "detail": "Error fetching data from upstream API"
}
nach oben