GET /blocks

画像参照を解決し、リクエスト順に ID でブロックを取得します。

画像参照が URL に解決された状態で、ウェブサイトのブロックを ID で取得します。ブロックは要求された 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‹GET /route NextGET /blocks/with-cel-cache›