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 Kulturpool-ID ab.

Parameter

Parameter Typ Beschreibung Beispiel
id string Die Kulturpool-ID als eindeutige UUID des Originaldatensatzes b1eaac0f-69a1-4174-8ac6-90a61615d0ae

Beispiel-URL

https://api.kulturpool.at/object/?id=b1eaac0f-69a1-4174-8ac6-90a61615d0ae

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": "https://api.kulturpool.at/ns/v1/edm.json",
    "id": "https://id.kulturpool.at/b1eaac0f-69a1-4174-8ac6-90a61615d0ae/aggregation",
    "type": "Aggregation",
    "provider": "Kulturpool",
    "dataProvider": "Wienbibliothek im Rathaus",
    "edmRights": "http://creativecommons.org/publicdomain/mark/1.0/",
    "isShownAt": "https://www.digital.wienbibliothek.at/id/475632",
    "isShownBy": {
      "id": "https://www.digital.wienbibliothek.at/download/webcache/1000/475634",
      "type": "WebResource",
      "hasService": {
        "id": "https://www.digital.wienbibliothek.at/i3f/v20/475634",
        "type": "Service",
        "conformsTo": [{ "id": "http://iiif.io/api/image" }],
        "implements": { "id": "http://iiif.io/api/image/2/level2.json" }
      },
      "isReferencedBy": [
        { "id": "https://www.digital.wienbibliothek.at/i3f/v20/475632/manifest" }
      ]
    },
    "hasView": [
      {
        "id": "https://www.digital.wienbibliothek.at/download/pdf/475632",
        "type": "WebResource"
      }
    ],
    "aggregatedCHO": {
      "id": "https://id.kulturpool.at/b1eaac0f-69a1-4174-8ac6-90a61615d0ae/cho",
      "type": "ProvidedCHO",
      "title": [
        "Neueste Nachrichten. Alpenländisches Morgenblatt mit Handels-Zeitung ... Nr. 207/ 2. Jahrgang/ 28. Juli 1915"
      ],
      "dcType": ["Plakat", "book", "poster"],
      "issued": ["1915"],
      "edmType": "TEXT",
      "spatial": ["Salzburg <Stadt>"],
      "language": ["ger"],
      "publisher": ["Neueste Nachrichten"],
      "identifier": ["urn:nbn:at:AT-WBR-22887"],
      "extent": ["1 Bogen, 48 x 32 cm"],
      "currentLocation": " ; P-226563 ; PS-A2-0003"
    }
  },
  "media": [
    {
      "url": "https://www.digital.wienbibliothek.at/i3f/v20/475632/manifest",
      "type": "iiif",
      "content_type": "application/json"
    },
    {
      "url": "https://www.digital.wienbibliothek.at/download/pdf/475632",
      "type": "pdf",
      "content_type": "application/pdf"
    }
  ]
}

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 kp_id. Der Wert dieses Feldes ist die Kulturpool-ID, die zum Abrufen der detaillierten Informationen über die Objekte API verwendet werden kann.

Fehlerbehandlung

404 - Objekt nicht gefunden

Wird zurückgegeben, wenn keine passende Kulturpool-ID 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