Közzétett dokumentumok lekérése egy sémához — mindet, egyet, egy köteget vagy egy oldalt — streamelt JSON tömbként.
Lekéri egy séma közzétett dokumentumait — mindet, egyetlen dokumentumot, azonosítók alapján egy köteget vagy egy oldalt — JSON tömbként streamelve. Elérhető a /schemas/{schema_name} útvonalon is. A képhivatkozások URL-re oldódnak, és amikor a language meg van adva, a megfelelő fordítás ráíródik az alap tartalomra.
Hitelesítés: API-kulcs. Csak akkor szükséges kulcs, ha a szerver a require_schema_api_key = true értéket állítja be; ellenkező esetben névtelen olvasás engedélyezett.
| Paraméter | Típus | Kötelező | Megjegyzés |
|---|---|---|---|
schema_name | string | igen | A dokumentumséma, például post. |
| Paraméter | Típus | Kötelező | Megjegyzés |
|---|---|---|---|
websiteId | uuid | nem | Célwebhely; visszaesik a Host fejléc / konfiguráció értékére. |
id | uuid | nem | Lekér egyetlen dokumentumot. Felülírja az ids paramétert. |
ids | string | nem | Vesszővel elválasztott UUID-k (köteg, legfeljebb 200). Felülírja a lapozást. |
language | string | nem | Az adott területi beállításhoz tartozó fordítást ráolvasztja az alap tartalomra. |
limit | integer | nem | Oldalméret, alapértelmezés szerint 200, legfeljebb 200. |
offset | integer | nem | Kihagyandó sorok száma (csak pozitív limit esetén alkalmazva). |
api_key | string | nem | Alternatívája az x-api-key fejlécnek. |
Ha sem id, sem ids nincs megadva, a dokumentumok published_at DESC sorrendben érkeznek vissza.
Egy streamelt JSON tömb. Minden elem a dokumentum közzétett tartalma a legfelső szinten, valamint a beszúrt _id, _title és _publishedAt kulcsok:
[
{
"_id": "...",
"_title": "Bevezetés",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Bevezetés",
"description": "...",
"content": "..."
}
]
Ütközés esetén a tartalommezők felülírják a beszúrt kulcsokat. A { alt, _asset: { id } } alakú képhivatkozások _asset alá egy feloldott url-t kapnak.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — érvénytelen websiteId, érvénytelen id, vagy hibás ids (üres, több mint 200, vagy érvénytelen UUID)401 — érvénytelen API-kulcs (vagy hiányzik, amikor szükséges)500 — lekérdezési hiba