GET /blocks

Récupérez des blocs par ID, dans l'ordre de la requête, avec les références d'image résolues.

Récupérez les blocs par ID pour un site web, avec les références d'image résolues en URL. Les blocs sont renvoyés dans le même ordre que les ids demandés ; les IDs inconnus sont ignorés sans message.

Authentification : clé d'API (en-tête x-api-key ou paramètre de requête api_key).

Paramètres de requête

Paramètre	Type	Obligatoire	Remarques
`websiteId`	uuid	non	Site web cible ; se rabat sur l'en-tête `Host` / la configuration.
`ids`	string	non	UUID de bloc séparés par des virgules. Vide ou absent → `[]`.
`api_key`	string	non	Alternative à l'en-tête `x-api-key`.

Réponse

Un tableau JSON de blocs :

[
  {
    "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"
  }
]

Exemple

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

Erreurs

400 — UUID invalide dans ids, ou site web impossible à résoudre
401 — clé d'API invalide

Previous‹GET /route NextGET /blocks/with-cel-cache›