Postream

Carregando o índice…

Documentação: Erros

Erros

Status HTTP e códigos estáveis de cada erro da API pública.

Todo erro vem como JSON com o status e um código estável. Compare pelo code, nunca por texto: a API não devolve frases.

{ "statusCode": 404, "code": "NOT_FOUND" }

Códigos

StatuscodeQuando
400BAD_USER_INPUTParâmetro inválido (perPage=500, page=abc, parâmetro repetido).
400LOCALE_NOT_ENABLEDlocale fora dos idiomas do site.
401UNAUTHENTICATEDChave ausente, inválida ou revogada.
403SECRET_KEY_IN_BROWSERChave secreta com Origin de navegador (e o site não liberou). Veja Domínios permitidos.
403ORIGIN_NOT_ALLOWEDChave publicável sem origem ou de uma origem fora dos domínios permitidos.
403KEY_KIND_NOT_ALLOWEDChave publicável na rota por site (/sites/{siteId}/…).
404NOT_FOUNDSlug inexistente, não publicado ou de outro site; chave de outro site na rota por site.
429RATE_LIMITEDLimite de requisições da chave. Veja Limite de requisições.

Respostas que não são erro

  • 301: slug antigo de um post publicado. Veja Buscar um post.
  • 304: nada mudou desde o ETag enviado. Veja Cache.

Como tratar

if (res.status === 404) return null; // o post não existe (ou saiu do ar)
if (!res.ok) {
  const { code } = await res.json();
  throw new Error(`Postream ${res.status} ${code}`);
}