블록 가져오기

이미지 참조를 URL로 해석하면서 요청 순서대로 ID로 블록을 가져옵니다.

웹사이트의 ID로 블록을 가져오며, 이미지 참조는 URL로 해석됩니다. 블록은 요청된 ids와 동일한 순서로 반환되고, 알 수 없는 ID는 조용히 건너뜁니다.

인증: API 키 (x-api-key 헤더 또는 api_key 쿼리 매개변수).

쿼리 매개변수

매개변수	유형	필수	비고
`websiteId`	uuid	아니요	대상 웹사이트; `Host` 헤더/구성으로 대체됩니다.
`ids`	string	아니요	쉼표로 구분된 블록 UUID입니다. 비어 있거나 없으면 → `[]`.
`api_key`	string	아니요	`x-api-key` 헤더에 대한 대안입니다.

응답

블록의 JSON 배열:

[
  {
    "id": "...",
    "website_id": "...",
    "schema_id": "...",
    "draft_content": {},
    "published_content": {},
    "state": "published",
    "version": 3,
    "schema_name": "hero-block",
    "layout": {},
    "cloned_from_id": null,
    "created_at": "2026-06-23T18:34:16Z",
    "updated_at": "2026-06-23T20:36:55Z"
  }
]

예시

curl '{CMS_API_URL}/blocks?websiteId=<uuid>&ids=<id1>,<id2>' \
  -H 'x-api-key: <key>'

오류

400 — ids에 잘못된 UUID가 있거나 웹사이트를 확인할 수 없음
401 — 잘못된 API 키

Previous‹라우트 가져오기 NextCEL 캐시가 포함된 블록 가져오기›