Preia documentele publicate pentru o schemă — toate, unul, un lot sau o pagină — ca un tablou JSON transmis în flux.
Preia documentele publicate pentru o schemă — toate, un singur document, un lot după ID-uri sau o pagină — difuzate ca un tablou JSON. Disponibil și la /schemas/{schema_name}. Referințele la imagini sunt rezolvate în URL-uri, iar atunci când language este setat, traducerea corespunzătoare este îmbinată peste conținutul de bază.
Autentificare: Cheie API. O cheie este necesară doar când serverul setează require_schema_api_key = true; altfel, sunt permise lecturi anonime.
| Parametru | Tip | Obligatoriu | Note |
|---|---|---|---|
schema_name | string | da | Schema documentului, de ex. post. |
| Parametru | Tip | Obligatoriu | Note |
|---|---|---|---|
websiteId | uuid | nu | Site-ul țintă; revine la antetul Host / configurație. |
id | uuid | nu | Preia un singur document. Are prioritate față de ids. |
ids | string | nu | UUID-uri separate prin virgule (lot, max. 200). Are prioritate față de paginare. |
language | string | nu | Îmbină traducerea pentru această localizare peste conținutul de bază. |
limit | integer | nu | Dimensiunea paginii, implicit 200, limitată la 200. |
offset | integer | nu | Rânduri de omis (se aplică doar cu o limită pozitivă). |
api_key | string | nu | Alternativă la antetul x-api-key. |
Când nici id, nici ids nu sunt setate, documentele sunt returnate ordonate după published_at DESC.
Un tablou JSON transmis în flux. Fiecare element este conținutul publicat al documentului expus la nivelul superior, plus cheile injectate _id, _title și _publishedAt:
[
{
"_id": "...",
"_title": "Getting Started",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Getting Started",
"description": "...",
"content": "..."
}
]
Câmpurile de conținut au prioritate față de cheile injectate în caz de coliziune. Referințele la imagini de forma { alt, _asset: { id } } primesc un url rezolvat, injectat în _asset.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — websiteId invalid, id invalid sau ids incorecte (goale, mai multe de 200 sau un UUID invalid)401 — cheie API invalidă (sau lipsă atunci când este necesară)500 — eșec la interogare