Pular para o conteúdo principal
Para ajudar os parceiros a diagnosticar e resolver problemas rapidamente, todas as APIs retornam uma resposta de erro estruturada. Este modelo é consistente entre endpoints e inclui contexto suficiente para depuração, sem expor detalhes internos. Toda resposta de erro segue o mesmo formato básico: 
{
  "code": "<error_code>",
  "title": "<error_title>",
  "message": "<error_message>"
}

​
Definições dos campos

  • code: Um identificador único e estável para o erro.
  • title: Um breve resumo do que deu errado.
  • message: Uma mensagem legível por humanos explicando como corrigir.
Sempre use o campo code para identificar erros programaticamente. Títulos e mensagens podem evoluir para melhorar a clareza.

​
Erros de validação em nível de campo

Quando um problema está relacionado a campos específicos no payload da requisição, a resposta inclui um objeto fields com informações mais granulares.

​
Exemplos

{
  "code": "IDE-0009",
  "title": "Missing Fields in Request",
  "message": "Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.",
  "fields": {
    "document": "document is a required field"
  }
}