Referência da API

Erros

Todo erro retorna um envelope JSON consistente, com um code legível por máquina e uma message legível por humanos. Faça o controle de fluxo pelo code, não pela message.

Formato do erro

4xx / 5xx

{
  "error": {
    "code": "validation",
    "message": "name is required and must be a non-empty string"
  }
}

Códigos de erro

Código	HTTP	Quando
`validation`	400	Um campo obrigatório está ausente ou malformado.
`quota_exceeded`	402	O limite do seu plano (alvos ou eventos) foi atingido.
`forbidden`	403	Chave de API ausente, inválida, revogada ou expirada — ou o recurso pertence a outra assinatura.
`not_found`	404	O recurso solicitado não existe.
`conflict`	409	Já existe um recurso com essa identidade.
`internal`	500	Um erro inesperado no servidor. Seguro para repetir.

Tratando erros

Trate 4xx como um problema do cliente a ser corrigido (entrada inválida, chave ausente, cota) e 5xx como transitório — repita respostas 500 com backoff exponencial. Sempre leia error.code para o controle de fluxo; error.message é para logs e humanos e pode mudar entre versões.