Errores
Estado HTTP y códigos estables de cada error de la API pública.
Todo error llega como JSON con el estado y un código estable. Compara por el code, nunca por texto: la API no devuelve frases.
{ "statusCode": 404, "code": "NOT_FOUND" }Códigos
| Estado | code | Cuándo |
|---|---|---|
| 400 | BAD_USER_INPUT | Parámetro inválido (perPage=500, page=abc, parámetro repetido). |
| 400 | LOCALE_NOT_ENABLED | locale fuera de los idiomas del sitio. |
| 401 | UNAUTHENTICATED | Clave ausente, inválida o revocada. |
| 403 | SECRET_KEY_IN_BROWSER | Clave secreta con Origin de navegador (y el sitio no lo permitió). Mira Dominios permitidos. |
| 403 | ORIGIN_NOT_ALLOWED | Clave publicable sin origen o de un origen fuera de los dominios permitidos. |
| 403 | KEY_KIND_NOT_ALLOWED | Clave publicable en la ruta por sitio (/sites/{siteId}/…). |
| 404 | NOT_FOUND | Slug inexistente, no publicado o de otro sitio; clave de otro sitio en la ruta por sitio. |
| 429 | RATE_LIMITED | Límite de solicitudes de la clave. Mira Límite de solicitudes. |
Respuestas que no son error
301: slug antiguo de un post publicado. Mira Buscar un post.304: nada cambió desde elETagenviado. Mira Caché.
Cómo tratarlos
if (res.status === 404) return null; // el post no existe (o salió del aire)
if (!res.ok) {
const { code } = await res.json();
throw new Error(`Postream ${res.status} ${code}`);
}