스키마에 대해 게시된 문서를 전체, 단일, 배치, 페이지 단위로 JSON 배열 스트림으로 가져옵니다.
스키마에 대해 게시된 문서를 JSON 배열로 스트리밍하여 가져옵니다. 전체 문서, 단일 문서, ID로 지정한 배치, 또는 페이지 단위로 가져올 수 있습니다. /schemas/{schema_name}에서도 사용할 수 있습니다. 이미지 참조는 URL로 해석되며, language가 설정되어 있으면 해당 번역이 기본 콘텐츠에 병합됩니다.
인증: API 키. 서버가 require_schema_api_key = true로 설정한 경우에만 키가 필요하며, 그렇지 않으면 익명 읽기가 허용됩니다.
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
schema_name | string | yes | 문서 스키마입니다. 예: post. |
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
websiteId | uuid | no | 대상 웹사이트입니다. 지정되지 않으면 Host 헤더/구성값이 사용됩니다. |
id | uuid | no | 단일 문서를 가져옵니다. ids보다 우선합니다. |
ids | string | no | 쉼표로 구분한 UUID 목록(배치, 최대 200개)입니다. 페이지 매김보다 우선합니다. |
language | string | no | 이 로케일에 해당하는 번역을 기본 콘텐츠 위에 병합합니다. |
limit | integer | no | 페이지 크기입니다. 기본값은 200, 최대값은 200입니다. |
offset | integer | no | 건너뛸 행 수입니다(양의 limit이 있을 때만 적용). |
api_key | string | no | x-api-key 헤더의 대안입니다. |
id와 ids가 모두 설정되지 않은 경우 문서는 published_at DESC 순으로 반환됩니다.
스트리밍되는 JSON 배열입니다. 각 요소는 문서의 게시된 콘텐츠가 최상위 수준에 펼쳐진 형태이며, 여기에 _id, _title, _publishedAt 키가 추가됩니다.
[
{
"_id": "...",
"_title": "Getting Started",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Getting Started",
"description": "...",
"content": "..."
}
]
동일한 키가 충돌하면 콘텐츠 필드가 주입된 키보다 우선합니다. { alt, _asset: { id } } 형태의 이미지 참조에는 _asset에 해석된 url이 추가됩니다.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — 잘못된 websiteId, 잘못된 id, 또는 잘못된 ids(비어 있거나 200개 초과 혹은 잘못된 UUID)401 — 잘못된 API 키(필수인데 없을 경우 포함)500 — 쿼리 실패