Veröffentlichte Dokumente für ein Schema abrufen — alle, eines, eine Gruppe oder eine Seite — als gestreamtes JSON-Array.
Rufe veröffentlichte Dokumente für ein Schema ab — alle, ein einzelnes Dokument, eine Gruppe nach IDs oder eine Seite — als gestreamtes JSON-Array. Ebenfalls verfügbar unter /schemas/{schema_name}. Bildreferenzen werden zu URLs aufgelöst, und wenn language gesetzt ist, wird die passende Übersetzung mit dem Basisinhalt zusammengeführt.
Auth: API-Schlüssel. Ein Schlüssel wird nur benötigt, wenn der Server require_schema_api_key = true setzt; andernfalls sind anonyme Lesezugriffe erlaubt.
| Parameter | Typ | Erforderlich | Hinweise |
|---|---|---|---|
schema_name | string | ja | Das Dokumentschema, z. B. post. |
| Parameter | Typ | Erforderlich | Hinweise |
|---|---|---|---|
websiteId | uuid | nein | Zielwebsite; fällt auf den Host-Header bzw. die Konfiguration zurück. |
id | uuid | nein | Ruft ein einzelnes Dokument ab. Hat Vorrang vor ids. |
ids | string | nein | Kommagetrennte UUIDs (Stapel, max. 200). Hat Vorrang vor der Paginierung. |
language | string | nein | Überlagert den Basisinhalt mit der Übersetzung für dieses Gebietsschema. |
limit | integer | nein | Seitengröße, Standard 200, begrenzt auf 200. |
offset | integer | nein | Zu überspringende Zeilen (wird nur bei positivem Limit angewendet). |
api_key | string | nein | Alternative zum Header x-api-key. |
Wenn weder id noch ids gesetzt ist, werden die Dokumente in der Reihenfolge published_at DESC zurückgegeben.
Ein gestreamtes JSON-Array. Jedes Element enthält den veröffentlichten Inhalt des Dokuments auf oberster Ebene sowie die eingefügten Schlüssel _id, _title und _publishedAt:
[
{
"_id": "...",
"_title": "Erste Schritte",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Erste Schritte",
"description": "...",
"content": "..."
}
]
Felder aus dem Inhalt haben bei Kollision Vorrang vor den eingefügten Schlüsseln. Bildreferenzen der Form { alt, _asset: { id } } erhalten eine aufgelöste url, die in _asset eingefügt wird.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — ungültige websiteId, ungültige id oder fehlerhafte ids (leer, mehr als 200 oder eine ungültige UUID)401 — ungültiger API-Schlüssel (oder fehlt, obwohl erforderlich)500 — Abfragefehler