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
| Status | code | Quando |
|---|---|---|
| 400 | BAD_USER_INPUT | Parâmetro inválido (perPage=500, page=abc, parâmetro repetido). |
| 400 | LOCALE_NOT_ENABLED | locale fora dos idiomas do site. |
| 401 | UNAUTHENTICATED | Chave ausente, inválida ou revogada. |
| 403 | SECRET_KEY_IN_BROWSER | Chave secreta com Origin de navegador (e o site não liberou). Veja Domínios permitidos. |
| 403 | ORIGIN_NOT_ALLOWED | Chave publicável sem origem ou de uma origem fora dos domínios permitidos. |
| 403 | KEY_KIND_NOT_ALLOWED | Chave publicável na rota por site (/sites/{siteId}/…). |
| 404 | NOT_FOUND | Slug inexistente, não publicado ou de outro site; chave de outro site na rota por site. |
| 429 | RATE_LIMITED | Limite 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 oETagenviado. 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}`);
}