Referencia y solución de problemas

Códigos de error y solución de problemas

Ver como Markdown

Formato de respuesta a errores

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

Los errores de negocio suelen seguir devolviendo la estructura unificada de JSON . Los integradores deben comprobar code primero. Los fallos de autenticación pueden devolver HTTP 401; la limitación de velocidad puede devolver HTTP 429.

Códigos de error comunes

Código de errorDescripción
0Éxito
1001No se proporciona información de autenticación válida
1002Token expirado
1003Token inválido, API Keyo firma
1004Token revocado
1006Fuente IP desajuste
2001Parámetro requerido faltante
2002Valor de parámetro inválido
2003Parámetro fuera de rango
3001Equilibrio insuficiente
3003Orden no encontrado
3004Solicitud duplicada
3005El pedido no puede ser cancelado
3006Permiso denegado
3100 - 3112Error de validación de parámetros de orden de condición
5001Error interno del servidor
5002Servicio temporalmente indisponible
5003Límite de tasa activado

Resolución de problemas

ProblemaRecomendación
1001 no hay información válida de autenticaciónComprueba si Authorization: Bearer <accessToken> o X-API-KEY está incluido.
1002 Token expiradoActualiza el Token o vuelve a iniciar sesión antes de volver a intentarlo.
1003 Token, API Keyo firma inválidaComprueba API Key, carga útil de firma, cuerpo de la JSON cadena de solicitud y orden de los parámetros de consulta.
1006 fuente IP desajusteRevisa la configuración API Key IP lista blanca.
3004 solicitud de duplicadoNo reutilices la misma firma para caminos relacionados con el orden. Regenera timestamp y signature.
5003 límite de tasa activadoReduce la frecuencia de las solicitudes y usa un retroceso exponencial si vuelves a intentarlo.
Timestamp outside of tolerance windowLlama a /v1/time para calibrar el desfasamiento de tiempo y firma la solicitud de nuevo.