Support Hub/API & Integrations/Codici di stato API: significato degli errori e come risolverli
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

Codici di stato API: significato degli errori e come risolverli

Ogni risposta della RESTful API contiene uno StatusCode numerico. Il codice 0 indica successo. Le risposte ai callback sono diverse: il tuo server risponde sempre {"status":"done"} con HTTP 200.

CodiceStatoCosa significaCosa fare
0SuccessL'operazione è stata completata.Niente.
1Invalid Request DataIl corpo JSON è malformato o contiene valori non validi.Invia JSON grezzo in UTF-8 con l'intestazione Content-Type: application/json. Controlla i valori.
2Invalid Service Tag IDIl parametro di query stgid non corrisponde ad alcun dispositivo registrato.Copia di nuovo il Service Tag ID dal tuo account API Monitor.
3Invalid RequestLa richiesta non segue il formato di quell'operazione.Confrontala con la richiesta di esempio dell'operazione.
4Invalid EncryptionNon è stato possibile decifrare il payload AES-256.Controlla la chiave di cifratura e la codifica Base64.
5Device OfflineIl dispositivo di destinazione non è connesso a Cams in questo momento.Controlla la pagina Device Status. Il comando viene messo in coda e consegnato quando il dispositivo si riconnette.
6Operation TimeoutIl dispositivo non ha confermato il comando in tempo.Verifica che il dispositivo sia online, poi riprova.
7Invalid Auth TokenL'AuthToken non corrisponde a quello impostato per il dispositivo.Usa il token di 32 caratteri dell'API Monitor.
8User Already ExistsÈ stata tentata un'aggiunta per un UserID già presente sul dispositivo.Aggiorna invece l'utente, oppure elimina prima l'utente.
9User Not FoundLo UserID non è presente sul dispositivo.Controlla lo UserID. Se serve, aggiungi prima l'utente.
10Template ErrorIl template biometrico è danneggiato o in un formato non supportato.Controlla i dati Base64, la Size e l'Index del template.
11Device Memory FullIl dispositivo ha raggiunto il limite di utenti o template.Elimina gli utenti o i template non più necessari.
13Invalid Security KeyLa chiave di sicurezza non corrisponde a quella nell'API Monitor.Usa la stessa chiave da entrambe le parti.
15Feature Not SupportedQuesto modello di dispositivo o modalità di connessione non supporta l'operazione.Controlla la modalità di connessione. Le modalità DB Pull e File Processing supportano solo l'invio delle presenze (push), non i comandi RESTful.
999Unknown ErrorUn errore imprevisto.Contatta il supporto Cams indicando l'OperationID.

Suggerimenti

  • Genera un OperationID univoco per ogni richiesta REST. La risposta lo ripete, così puoi abbinare richiesta e risposta.
  • I comandi REST impiegano circa 15 secondi per raggiungere il dispositivo.
  • I codici 12 e 14 non sono utilizzati.

Correlati: Callback URL che non riceve dati, Aggiungere o eliminare utenti in blocco.

Serve aiuto? Scrivi a support@camsbiometrics.com indicando l'OperationID e lo StatusCode.

Was this article helpful?