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 usualmente aún devolven la estructura unificada de JSON . Los integradores deberían revisar code primero. Las fallas de autenticación pueden devolver HTTP 401; La limitación de velocidad puede regresar HTTP 429.

Códigos de error comunes

Código de errorDescripción
0Éxito
1001No se proporciona información válida de autenticación
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 encontrada
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 no disponible
5003Límite de tasa activado

Solución de problemas

ProblemaRecomendación
1001 no hay información válida de autenticaciónRevisa si Authorization: Bearer <accessToken> o X-API-KEY está incluido.
1002 Token expiradoActualizar el Token o iniciar sesión de nuevo antes de intentarlo de nuevo.
1003 Token, API Keyo firma inválidaRevisa API Key, carga útil de firma, cuerpo de solicitud JSON cadena 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 rutas relacionadas con el orden. Regenerar timestamp y signature.
5003 límite de tasa activadoReduce la frecuencia de solicitudes y usa retroceso exponencial si vuelves a intentarlo.
Timestamp outside of tolerance windowLlama a /v1/time para calibrar el offset de tiempo y firma la solicitud de nuevo.