Erros

Formato da resposta

Todos os erros retornam um corpo JSON:

{
  "error": {
    "code": "validation_failed",
    "message": "The given data was invalid.",
    "details": {
      "email": ["The email has already been taken."]
    }
  },
  "request_id": "req_01HXXXXXX"
}

Inclua sempre o request_id ao contactar o suporte sobre um erro.

Códigos de estado HTTP

Estado	Significado
200 OK	Sucesso
201 Created	Recurso criado
400 Bad Request	Pedido mal formado
401 Unauthorized	Token em falta ou inválido
403 Forbidden	Token válido mas permissões insuficientes
404 Not Found	Recurso não encontrado
409 Conflict	Conflito (ex. email já em uso)
422 Unprocessable Entity	Validação falhou
429 Too Many Requests	Limite de taxa excedido
500 Internal Server Error	Erro do lado do servidor

Códigos de erro

Código	Descrição
validation_failed	O corpo do pedido falhou na validação
unauthorized	Token em falta ou expirado
forbidden	O token não tem o âmbito necessário
not_found	O recurso não existe
conflict	Violação de restrição de unicidade
rate_limited	Demasiados pedidos
internal_error	Erro de servidor inesperado