GET /dataset/{schema_name}

Извличайте публикувани документи за схема — всички, единичен документ, партида по идентификатори или страница — стриймвани като JSON масив. Налично е и на /schemas/{schema_name}. Препратките към изображения се преобразуват в URL адреси, а когато е зададен language, съответният превод се слива с базовото съдържание.

Автентикация: API ключ. Ключ се изисква само когато сървърът зададе require_schema_api_key = true; в противен случай са разрешени анонимни четения.

Параметри на пътя

Параметри на заявката

Когато нито id, нито ids е зададен, документите се връщат подредени по published_at DESC.

Отговор

Стриймван JSON масив. Всеки елемент представлява публикуваното съдържание на документа, разположено на най-горно ниво, плюс вмъкнатите ключове _id, _title и _publishedAt:

[
  {
    "_id": "...",
    "_title": "Първи стъпки",
    "_publishedAt": "2026-06-23T20:36:31Z",
    "title": "Първи стъпки",
    "description": "...",
    "content": "..."
  }
]

Полетата на съдържанието имат предимство пред вмъкнатите ключове при конфликт. Препратките към изображения с форма { alt, _asset: { id } } получават резолван url, вмъкнат в _asset.

Пример

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

Грешки

• 400 — невалиден websiteId, невалиден id или неправилни ids (празни, повече от 200 или невалиден UUID)
• 401 — невалиден API ключ (или липсва, когато се изисква)
• 500 — неуспешна заявка