Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Developer
Códigos de estado de la API: qué significa cada error y su solución
Cada respuesta de la API RESTful lleva un StatusCode numérico. El código 0 significa éxito. Las respuestas de callback son distintas: tu servidor siempre responde {"status":"done"} con HTTP 200.
| Código | Estado | Qué significa | Qué hacer |
|---|---|---|---|
| 0 | Success | La operación se completó. | Nada. |
| 1 | Invalid Request Data | El cuerpo JSON está mal formado o tiene valores no válidos. | Envía JSON sin procesar en UTF-8 con el encabezado Content-Type: application/json. Revisa los valores. |
| 2 | Invalid Service Tag ID | El parámetro de consulta stgid no coincide con ningún dispositivo registrado. | Vuelve a copiar el Service Tag ID desde tu cuenta de API Monitor. |
| 3 | Invalid Request | La solicitud no sigue el formato de esa operación. | Compárala con la solicitud de ejemplo de la operación. |
| 4 | Invalid Encryption | No se pudo descifrar la carga AES-256. | Revisa la clave de cifrado y la codificación Base64. |
| 5 | Device Offline | El dispositivo de destino no está conectado a Cams en este momento. | Revisa la página Device Status. El comando se pone en cola y se entrega cuando el dispositivo se reconecta. |
| 6 | Operation Timeout | El dispositivo no confirmó el comando a tiempo. | Comprueba que el dispositivo esté en línea y vuelve a intentarlo. |
| 7 | Invalid Auth Token | El AuthToken no coincide con el configurado para el dispositivo. | Usa el token de 32 caracteres del API Monitor. |
| 8 | User Already Exists | Se intentó agregar un UserID que ya está en el dispositivo. | Actualiza el usuario en su lugar, o elimínalo primero. |
| 9 | User Not Found | El UserID no está en el dispositivo. | Revisa el UserID. Agrega primero el usuario si es necesario. |
| 10 | Template Error | La plantilla biométrica está dañada o tiene un formato no compatible. | Revisa los datos Base64, el Size y el Index de la plantilla. |
| 11 | Device Memory Full | El dispositivo alcanzó su límite de usuarios o plantillas. | Elimina los usuarios o plantillas que ya no se necesiten. |
| 13 | Invalid Security Key | La clave de seguridad no coincide con la del API Monitor. | Usa la misma clave en ambos lados. |
| 15 | Feature Not Supported | Este modelo de dispositivo o modo de conexión no admite la operación. | Revisa el modo de conexión. Los modos DB Pull y File Processing solo admiten el envío de asistencia, no comandos RESTful. |
| 999 | Unknown Error | Un error inesperado. | Contacta al soporte de Cams e indica el OperationID. |
Consejos
- Genera un OperationID único para cada solicitud REST. La respuesta lo repite, así puedes emparejar solicitud y respuesta.
- Los comandos REST tardan unos 15 segundos en llegar al dispositivo.
- Los códigos 12 y 14 no se usan.
Relacionado: Callback URL not receiving data, Add or delete users in bulk.
¿Necesitas ayuda? Escribe a support@camsbiometrics.com con el OperationID y el StatusCode.
Was this article helpful?