Postream

Cargando el índice…

Documentación: Errores

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

EstadocodeCuándo
400BAD_USER_INPUTParámetro inválido (perPage=500, page=abc, parámetro repetido).
400LOCALE_NOT_ENABLEDlocale fuera de los idiomas del sitio.
401UNAUTHENTICATEDClave ausente, inválida o revocada.
403SECRET_KEY_IN_BROWSERClave secreta con Origin de navegador (y el sitio no lo permitió). Mira Dominios permitidos.
403ORIGIN_NOT_ALLOWEDClave publicable sin origen o de un origen fuera de los dominios permitidos.
403KEY_KIND_NOT_ALLOWEDClave publicable en la ruta por sitio (/sites/{siteId}/…).
404NOT_FOUNDSlug inexistente, no publicado o de otro sitio; clave de otro sitio en la ruta por sitio.
429RATE_LIMITEDLí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 el ETag enviado. 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}`);
}