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.
| Codice | Stato | Cosa significa | Cosa fare |
|---|---|---|---|
| 0 | Success | L'operazione è stata completata. | Niente. |
| 1 | Invalid Request Data | Il corpo JSON è malformato o contiene valori non validi. | Invia JSON grezzo in UTF-8 con l'intestazione Content-Type: application/json. Controlla i valori. |
| 2 | Invalid Service Tag ID | Il parametro di query stgid non corrisponde ad alcun dispositivo registrato. | Copia di nuovo il Service Tag ID dal tuo account API Monitor. |
| 3 | Invalid Request | La richiesta non segue il formato di quell'operazione. | Confrontala con la richiesta di esempio dell'operazione. |
| 4 | Invalid Encryption | Non è stato possibile decifrare il payload AES-256. | Controlla la chiave di cifratura e la codifica Base64. |
| 5 | Device Offline | Il 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. |
| 6 | Operation Timeout | Il dispositivo non ha confermato il comando in tempo. | Verifica che il dispositivo sia online, poi riprova. |
| 7 | Invalid Auth Token | L'AuthToken non corrisponde a quello impostato per il dispositivo. | Usa il token di 32 caratteri dell'API Monitor. |
| 8 | User Already Exists | È stata tentata un'aggiunta per un UserID già presente sul dispositivo. | Aggiorna invece l'utente, oppure elimina prima l'utente. |
| 9 | User Not Found | Lo UserID non è presente sul dispositivo. | Controlla lo UserID. Se serve, aggiungi prima l'utente. |
| 10 | Template Error | Il template biometrico è danneggiato o in un formato non supportato. | Controlla i dati Base64, la Size e l'Index del template. |
| 11 | Device Memory Full | Il dispositivo ha raggiunto il limite di utenti o template. | Elimina gli utenti o i template non più necessari. |
| 13 | Invalid Security Key | La chiave di sicurezza non corrisponde a quella nell'API Monitor. | Usa la stessa chiave da entrambe le parti. |
| 15 | Feature Not Supported | Questo 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. |
| 999 | Unknown Error | Un 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?