Referência e Resolução de Problemas

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

Ver como Markdown

Formato de Resposta ao Erro

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

Os erros de negócio geralmente continuam a devolver a estrutura unificada de JSON . Os integradores devem verificar code primeiro. Falhas de autenticação podem devolver HTTP 401; a limitação de taxa pode devolver HTTP 429.

Códigos de Erro Comuns

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

Resolução de problemas

ProblemaRecomendação
1001 nenhuma informação de autenticação válidaVerifica 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álidaVerifique API Key, carga útil de assinatura, corpo JSON string de pedido e ordem dos parâmetros de consulta.
1006 fonte IP incompatibilidadeVerifique a configuração API Key IP whitelist.
3004 pedido de duplicaçãoNão reutilize a mesma assinatura para caminhos relacionados com a ordem. Regenerar timestamp e signature.
5003 limite de taxa ativadoReduza a frequência dos pedidos e use um recuo exponencial se tentar novamente.
Timestamp outside of tolerance windowLigue /v1/time para calibrar o desfasamento temporal e assine o pedido novamente.