Ir para a navegação
Referência e Solução de Problemas

Códigos de Erro e Solução de Problemas

Ver como Markdown

Formato de Resposta de Erro

{
  "code": 1003,
  "message": "Invalid token",
  "requestId": "req-12345678"
}

Erros de negócio geralmente ainda retornam a estrutura unificada de JSON . Integradores devem verificar code primeiro. Falhas de autenticação podem retornar HTTP 401; limitação de taxa pode retornar HTTP 429.

Códigos de Erro Comuns

Código de erroDescrição
0Sucesso
1001Nenhuma informação válida de autenticação fornecida
1002Token expirado
1003Token inválido, API Keyou assinatura
1004Token revogado
1006Fonte IP descompasso
2001Parâmetro exigido ausente
2002Valor inválido do parâmetro
2003Parâmetro fora do alcance
3001Equilíbrio insuficiente
3003Ordem não encontrada
3004Solicitação duplicada
3005Pedido não pode ser cancelado
3006Permissão negada
3100 - 3112Erro de validação do parâmetro de ordem da condição
5001Erro interno do servidor
5002Serviço temporariamente indisponível
5003Limite de taxa acionado

Solução de problemas

ProblemaRecomendação
1001 nenhuma informação válida de autenticaçãoVerifique se Authorization: Bearer <accessToken> ou X-API-KEY está incluído.
1002 Token expiradoAtualize o Token ou faça login novamente antes de tentar novamente.
1003 Token, API Keyou assinatura inválidasVerifique API Key, carga útil de assinatura, corpo JSON string de solicitação e ordem dos parâmetros de consulta.
1006 fonte IP descompassoVerifique a configuração da lista branca API Key IP .
3004 pedido de duplicaçãoNão reutilize a mesma assinatura para caminhos relacionados à ordem. Regenerar timestamp e signature.
5003 limite de taxa acionadoReduza a frequência dos pedidos e use um backoff exponencial se tentar novamente.
Timestamp outside of tolerance windowLigue para /v1/time calibrar o desfasamento temporal e assine o pedido novamente.

Guias diagnósticos relacionados