Tratamento de erros

Um Erro possui alguns campos que ajudam a identificar a causa do problema.

code

O campo code mostra o grupo ao qual o erro pertence. A maioria deles possui um campo subErrors com detalhes mais específicos. São estes os grupos:

  • INTERNAL_SERVER_ERROR: Erro interno da aplicação.

  • BAD_REQUEST_BODY: Requisição mal construída. Normalmente acontece quando o body não corresponde ao formato esperado.

  • NOT_FOUND: Recurso não encontrado.

  • UNAUTHORIZED: Não autorizado. Representa algum problema de autenticação com a API.

message

Este campo contém uma mensagem legível sobre a causa do problema.

subErrors

Alguns tipos de erro possuem um camposubErrors que contém uma lista com detalhes específicos sobre a causa do problema. Assim como o campo Error, este possui code, msg.

BAD_REQUEST_BODY

  • INVALID_TOKEN: Token inválido.

  • INVALID_ID: ID inválido.

  • ASSET_CODE_ALREADY_EXISTS: Você já emitiu um Ativo com este código.

  • TRANSFER_UNDERFUNDED: Saldo insuficiente para Transferência.

  • INVALID_ACTION_TYPE: Tipo de Ação inválido.

  • BATCH_LIMIT_EXCEEDED: Limite de Ações em um Lote excedido.

  • TRIGGER_INVALID_TYPE: Tipo de Trigger inválido.

  • TRIGGER_INVALID_CONDITION: Condição de Trigger inválida.

  • ACCOUNT_ALREADY_HAS_CREDENTIAL: Esta Conta já possui um par de Credenciais criado.

  • INVALID_AMOUNT: Valor inválido especificado.

  • INVALID_FIELD: Campo inválido.

  • FIELDS_WITH_INVALID_VALUE: O campo 'fields' deve ser um objeto somente com valores do tipo 'string'.

UNAUTHORIZED

  • MISSING_KYC: Necessitamos de algumas informações para habilitar nosso ambiente de produção.

  • PERMISSION_DENIED: Não é possível realizar esta Ação, verifique suas permissões.

  • INTEGRATION_NOT_ENABLED: Integração não habilitada.

NOT_FOUND

  • FIELD_NOT_FOUND: Campo não encontrado.

  • TRANSFER_FROM_NOT_FOUND: Remetente da Transferência não encontrado.

  • TRANSFER_TO_NOT_FOUND: Destinatário da Transferência não encontrado.

  • TRANSFER_ASSET_NOT_FOUND: Ativo não encontrado.