GET /dataset/{schema_name}

Dohvatite objavljene dokumente za shemu — sve, jedan, skup ili stranicu — kao strujani JSON niz.

Dohvatite objavljene dokumente za shemu — sve, pojedinačni dokument, skup prema ID-ovima ili stranicu — strujano kao JSON niz. Dostupno i na /schemas/{schema_name}. Reference na slike razrješavaju se u URL-ove, a kada je postavljen language, odgovarajući prijevod spaja se s osnovnim sadržajem.

Autentikacija: API ključ. Ključ je potreban samo kada poslužitelj postavi require_schema_api_key = true; inače su anonimna čitanja dopuštena.

Parametri putanje

Parametar	Tip	Obavezno	Napomene
`schema_name`	string	da	Shema dokumenta, npr. `post`.

Parametri upita

Parametar	Tip	Obavezno	Napomene
`websiteId`	uuid	ne	Ciljana web-stranica; vraća se na zaglavlje / konfiguraciju `Host`.
`id`	uuid	ne	Dohvati jedan dokument. Ima prednost nad `ids`.
`ids`	string	ne	Zarezom odvojeni UUID-ovi (skupno, najviše 200). Ima prednost nad paginacijom.
`language`	string	ne	Spoji prijevod za ovu lokalnu postavku preko osnovnog sadržaja.
`limit`	integer	ne	Veličina stranice, zadano `200`, ograničeno na `200`.
`offset`	integer	ne	Broj redaka koji se preskače (primjenjuje se samo uz pozitivan limit).
`api_key`	string	ne	Alternativa zaglavlju `x-api-key`.

Kada nisu postavljeni id ni ids, dokumenti se vraćaju poredani prema published_at DESC.

Odgovor

Strujani JSON niz. Svaki element predstavlja objavljeni sadržaj dokumenta raspoređen na najvišoj razini, uz umetnute ključeve _id, _title i _publishedAt:

[
  {
    "_id": "...",
    "_title": "Početak rada",
    "_publishedAt": "2026-06-23T20:36:31Z",
    "title": "Početak rada",
    "description": "...",
    "content": "..."
  }
]

Polja sadržaja imaju prednost nad umetnutim ključevima u slučaju kolizije. Referencama na slike oblika { alt, _asset: { id } } u _asset se umeće razriješen url.

Primjer

curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
  -H 'x-api-key: <key>'

Pogreške

400 — neispravan websiteId, neispravan id ili loš ids (prazan, više od 200 ili nevažeći UUID)
401 — neispravan API ključ (ili nedostaje kada je potreban)
500 — neuspješan upit

Previous‹GET /components/{name}NextGET /content-changes (SSE)›

Parametar

Tip

Obavezno

Napomene

schema_name

string

Shema dokumenta, npr. post.

Parametri upita

Parametar

Tip

Obavezno

Napomene

websiteId

uuid

Ciljana web-stranica; vraća se na zaglavlje / konfiguraciju Host.

id

uuid

Dohvati jedan dokument. Ima prednost nad ids.

ids

string

Zarezom odvojeni UUID-ovi (skupno, najviše 200). Ima prednost nad paginacijom.

language

string

Spoji prijevod za ovu lokalnu postavku preko osnovnog sadržaja.

limit

integer

Veličina stranice, zadano 200, ograničeno na 200.

offset

integer

Broj redaka koji se preskače (primjenjuje se samo uz pozitivan limit).

api_key

string

Alternativa zaglavlju x-api-key.

Kada nisu postavljeni id ni ids, dokumenti se vraćaju poredani prema published_at DESC.

Odgovor

Strujani JSON niz. Svaki element predstavlja objavljeni sadržaj dokumenta raspoređen na najvišoj razini, uz umetnute ključeve _id, _title i _publishedAt:

[
  {
    "_id": "...",
    "_title": "Početak rada",
    "_publishedAt": "2026-06-23T20:36:31Z",
    "title": "Početak rada",
    "description": "...",
    "content": "..."
  }
]

Polja sadržaja imaju prednost nad umetnutim ključevima u slučaju kolizije. Referencama na slike oblika { alt, _asset: { id } } u _asset se umeće razriješen url.