Códigos de error
Los códigos de error tienen dos capas. El code externo refleja el resultado de la capa de API y data.bizCode refleja el resultado de negocio. Una llamada solo es correcta cuando se cumplen code == 0 y data.bizCode == 0. Consulta Estructura de respuesta unificada.
Códigos de error de la API (code)
| code | Descripción | Sugerencia |
|---|---|---|
| 0 | Éxito | — |
| 401 | Autenticación fallida | Busca la causa concreta en la tabla siguiente |
| 429 | Too Many Requests | Reduce la frecuencia de llamadas y vuelve a intentarlo; cada API admite hasta 10 solicitudes / segundo |
Causas del error 401
| Mensaje | Significado | Sugerencia |
|---|---|---|
| Missing required headers | Falta una cabecera de solicitud obligatoria | Comprueba que estén presentes todas las Cabeceras de solicitud comunes |
| Invalid timestamp format | El formato de la marca de tiempo es incorrecto | X-Timestamp debe ser una marca de tiempo en segundos |
| Request timestamp expired | La marca de tiempo de la solicitud ha caducado | Sincroniza el reloj del servidor y vuelve a enviar la solicitud |
| Invalid nonce format | El nonce no cumple la regla de formato | Debe coincidir con ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | El nonce ya se ha usado o no ha superado la validación | Usa una cadena aleatoria nueva en cada solicitud; no la reutilices nunca |
| appId not found | El appId no existe | Comprueba APP-ID |
| appId is disabled | El appId está deshabilitado | Ponte en contacto con el soporte técnico |
| Signature calculation failed | Error al calcular la firma | Revisa tu implementación de la firma; consulta Mecanismo de firma |
| Signature verification failed | Error al verificar la firma | Comprueba el orden de concatenación de la cadena a firmar, que path incluya el prefijo /open-apis y que timestamp y nonce coincidan con las cabeceras |
Códigos de error de negocio (bizCode)
| bizCode | Descripción |
|---|---|
| 0 | Éxito |
| 10000001 | Parámetros no válidos |
| 10000003 | Demasiadas solicitudes. Espera y vuelve a intentarlo |
| 10000103 | El servicio del sistema presenta una anomalía; ponte en contacto con el servicio de atención al cliente |
| 100027001 | Parámetros de operación de créditos no válidos |
| 100027003 | Saldo de créditos insuficiente |
| 100041003 | La tarea de modelado espacial no existe |
| 100041004 | No se ha encontrado el resultado del modelado espacial |
| 100041006 | No se ha encontrado el espacio |
| 100041010 | El AppId no tiene permiso de modelado espacial |
| 100041016 | Estado de la tarea [modelando]; no se permite eliminarla |
| 100041017 | La tarea no se puede cancelar en su estado actual |
Solución de problemas de modelado fallido
Cuando una tarea pasa a Modelado fallido (9), llama a Lista paginada de tareas o a Detalles de tareas y lee errorCode y failedReason para averiguar la causa.
Estos dos campos transmiten información de fallos desde el interior del proceso de modelado y usan un conjunto de valores distinto del de bizCode anterior. Cuando una llamada a la API es correcta pero la tarea no consigue modelarse, bizCode sigue siendo 0.