Support Hub/API & Integrations/Códigos de estado de la API: qué significa cada error y su…
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ódigoEstadoQué significaQué hacer
0SuccessLa operación se completó.Nada.
1Invalid Request DataEl 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.
2Invalid Service Tag IDEl 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.
3Invalid RequestLa solicitud no sigue el formato de esa operación.Compárala con la solicitud de ejemplo de la operación.
4Invalid EncryptionNo se pudo descifrar la carga AES-256.Revisa la clave de cifrado y la codificación Base64.
5Device OfflineEl 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.
6Operation TimeoutEl dispositivo no confirmó el comando a tiempo.Comprueba que el dispositivo esté en línea y vuelve a intentarlo.
7Invalid Auth TokenEl AuthToken no coincide con el configurado para el dispositivo.Usa el token de 32 caracteres del API Monitor.
8User Already ExistsSe intentó agregar un UserID que ya está en el dispositivo.Actualiza el usuario en su lugar, o elimínalo primero.
9User Not FoundEl UserID no está en el dispositivo.Revisa el UserID. Agrega primero el usuario si es necesario.
10Template ErrorLa plantilla biométrica está dañada o tiene un formato no compatible.Revisa los datos Base64, el Size y el Index de la plantilla.
11Device Memory FullEl dispositivo alcanzó su límite de usuarios o plantillas.Elimina los usuarios o plantillas que ya no se necesiten.
13Invalid Security KeyLa clave de seguridad no coincide con la del API Monitor.Usa la misma clave en ambos lados.
15Feature Not SupportedEste 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.
999Unknown ErrorUn 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?