Récupère les documents publiés pour un schéma — tous, un seul, un lot ou une page — sous forme de tableau JSON diffusé.
Récupère les documents publiés pour un schéma — tous, un seul document, un lot par identifiants ou une page — diffusés en continu sous forme de tableau JSON. Également disponible à /schemas/{schema_name}. Les références d’image sont résolues en URL, et lorsque language est défini la traduction correspondante est fusionnée avec le contenu de base.
Auth : Clé API. Une clé n’est requise que lorsque le serveur définit require_schema_api_key = true; sinon, les lectures anonymes sont autorisées.
| Paramètre | Type | Obligatoire | Notes |
|---|---|---|---|
schema_name | string | oui | Le schéma de document, par exemple post. |
| Paramètre | Type | Obligatoire | Notes |
|---|---|---|---|
websiteId | uuid | non | Site web cible; se replie sur l’en-tête / la configuration Host. |
id | uuid | non | Récupère un seul document. Prioritaire sur ids. |
ids | string | non | UUID séparés par des virgules (lot, 200 max). Prioritaire sur la pagination. |
language | string | non | Fusionne la traduction pour cette locale avec le contenu de base. |
limit | integer | non | Taille de page, par défaut 200, plafonnée à 200. |
offset | integer | non | Nombre de lignes à ignorer (appliqué uniquement avec une limite positive). |
api_key | string | non | Alternative à l’en-tête x-api-key. |
Lorsque ni id ni ids ne sont définis, les documents sont renvoyés triés par published_at DESC.
Un tableau JSON diffusé en continu. Chaque élément correspond au contenu publié du document aplati au niveau supérieur, plus les clés _id, _title et _publishedAt injectées :
[
{
"_id": "...",
"_title": "Getting Started",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Getting Started",
"description": "...",
"content": "..."
}
]
Les champs de contenu prévalent sur les clés injectées en cas de collision. Les références d’image de la forme { alt, _asset: { id } } reçoivent une url résolue injectée dans _asset.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — websiteId invalide, id invalide ou ids incorrect (vide, plus de 200 ou UUID invalide)401 — clé API invalide (ou manquante lorsqu’elle est requise)500 — échec de la requête