Support Hub/API & Integrations/Códigos de status da API: o que cada erro significa e como…
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ódigoStatusO que significaO que fazer
0SuccessA operação foi concluída.Nada.
1Invalid Request DataO 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.
2Invalid Service Tag IDO parâmetro de consulta stgid não corresponde a nenhum dispositivo registrado.Copie novamente o Service Tag ID da sua conta do API Monitor.
3Invalid RequestA requisição não segue o formato dessa operação.Compare-a com a requisição de exemplo da operação.
4Invalid EncryptionNão foi possível descriptografar o payload AES-256.Verifique a chave de criptografia e a codificação Base64.
5Device OfflineO 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.
6Operation TimeoutO dispositivo não confirmou o comando a tempo.Verifique se o dispositivo está online e tente novamente.
7Invalid Auth TokenO AuthToken não corresponde ao definido para o dispositivo.Use o token de 32 caracteres do API Monitor.
8User Already ExistsFoi tentada a adição de um UserID que já está no dispositivo.Atualize o usuário ou exclua o usuário antes.
9User Not FoundO UserID não está no dispositivo.Verifique o UserID. Adicione o usuário antes, se necessário.
10Template ErrorO template biométrico está corrompido ou em um formato não suportado.Verifique os dados Base64, o Size e o Index do template.
11Device Memory FullO dispositivo atingiu o limite de usuários ou templates.Exclua usuários ou templates que não são mais necessários.
13Invalid Security KeyA security key não corresponde à do API Monitor.Use a mesma chave nos dois lados.
15Feature Not SupportedEste 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.
999Unknown ErrorUm 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?