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 status da API: o que cada erro significa e como corrigir
Toda resposta da API RESTful traz um StatusCode numérico. O código 0 significa sucesso. As respostas de callback são diferentes: o seu servidor sempre responde {"status":"done"} com HTTP 200.
| Código | Status | O que significa | O que fazer |
|---|---|---|---|
| 0 | Success | A operação foi concluída. | Nada. |
| 1 | Invalid Request Data | O corpo JSON está malformado ou tem valores inválidos. | Envie JSON bruto em UTF-8 com o cabeçalho Content-Type: application/json. Verifique os valores. |
| 2 | Invalid Service Tag ID | O parâmetro de consulta stgid não corresponde a nenhum dispositivo registrado. | Copie novamente o Service Tag ID da sua conta do API Monitor. |
| 3 | Invalid Request | A requisição não segue o formato dessa operação. | Compare-a com a requisição de exemplo da operação. |
| 4 | Invalid Encryption | Não foi possível descriptografar o payload AES-256. | Verifique a chave de criptografia e a codificação Base64. |
| 5 | Device Offline | O dispositivo de destino não está conectado ao Cams agora. | Verifique a página Device Status. O comando fica na fila e é entregue quando o dispositivo se reconectar. |
| 6 | Operation Timeout | O dispositivo não confirmou o comando a tempo. | Verifique se o dispositivo está online e tente novamente. |
| 7 | Invalid Auth Token | O AuthToken não corresponde ao definido para o dispositivo. | Use o token de 32 caracteres do API Monitor. |
| 8 | User Already Exists | Foi tentada a adição de um UserID que já está no dispositivo. | Atualize o usuário ou exclua o usuário antes. |
| 9 | User Not Found | O UserID não está no dispositivo. | Verifique o UserID. Adicione o usuário antes, se necessário. |
| 10 | Template Error | O template biométrico está corrompido ou em um formato não suportado. | Verifique os dados Base64, o Size e o Index do template. |
| 11 | Device Memory Full | O dispositivo atingiu o limite de usuários ou templates. | Exclua usuários ou templates que não são mais necessários. |
| 13 | Invalid Security Key | A security key não corresponde à do API Monitor. | Use a mesma chave nos dois lados. |
| 15 | Feature Not Supported | Este modelo de dispositivo ou modo de conexão não suporta a operação. | Verifique o modo de conexão. Os modos DB Pull e File Processing suportam apenas o envio (push) de presença, não comandos RESTful. |
| 999 | Unknown Error | Um erro inesperado. | Entre em contato com o suporte do Cams e informe o OperationID. |
Dicas
- Gere um OperationID único para cada requisição REST. A resposta o repete, assim você pode associar requisição e resposta.
- Os comandos REST levam cerca de 15 segundos para chegar ao dispositivo.
- Os códigos 12 e 14 não são usados.
Relacionado: Callback URL não recebe dados, Adicionar ou excluir usuários em massa.
Precisa de ajuda? Envie um e-mail para support@camsbiometrics.com com o OperationID e o StatusCode.
Was this article helpful?