Obtén documentos publicados para un esquema — todos, uno, un lote o una página — como un arreglo JSON transmitido.
Obtén documentos publicados para un esquema — todos, un único documento, un lote por ID o una página — transmitidos como un arreglo JSON. También disponible en /schemas/{schema_name}. Las referencias de imágenes se resuelven a URL y, cuando se establece language, la traducción correspondiente se fusiona con el contenido base.
Auth: Clave de API. Solo se requiere una clave cuando el servidor establece require_schema_api_key = true; de lo contrario, se permiten lecturas anónimas.
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
schema_name | string | sí | El esquema del documento, p. ej. post. |
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
websiteId | uuid | no | Sitio web de destino; recurre al encabezado/configuración Host. |
id | uuid | no | Obtiene un solo documento. Tiene prioridad sobre ids. |
ids | string | no | UUID separados por comas (lote, máx. 200). Tiene prioridad sobre la paginación. |
language | string | no | Fusiona la traducción para esta configuración regional con el contenido base. |
limit | integer | no | Tamaño de página, predeterminado 200, con límite superior de 200. |
offset | integer | no | Filas que omitir (solo se aplica con un límite positivo). |
api_key | string | no | Alternativa al encabezado x-api-key. |
Cuando no se establece ni id ni ids, los documentos se devuelven ordenados por published_at DESC.
Un arreglo JSON transmitido. Cada elemento es el contenido publicado del documento expandido en el nivel superior, más las claves inyectadas _id, _title y _publishedAt:
[
{
"_id": "...",
"_title": "Primeros pasos",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Primeros pasos",
"description": "...",
"content": "..."
}
]
Los campos de contenido tienen prioridad sobre las claves inyectadas en caso de colisión. Las referencias de imagen con la forma { alt, _asset: { id } } reciben un url resuelto inyectado en _asset.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — websiteId inválido, id inválido o ids incorrecto (vacío, más de 200 o un UUID inválido)401 — clave de API inválida (o ausente cuando es requerida)500 — error en la consulta