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
API-Statuscodes: Bedeutung der Fehler und ihre Behebung
Jede Antwort der RESTful API enthält einen numerischen StatusCode. Code 0 bedeutet Erfolg. Callback-Antworten sind anders: Ihr Server antwortet immer mit {"status":"done"} und HTTP 200.
| Code | Status | Bedeutung | Was zu tun ist |
|---|---|---|---|
| 0 | Success | Der Vorgang wurde abgeschlossen. | Nichts. |
| 1 | Invalid Request Data | Der JSON-Body ist fehlerhaft oder enthält ungültige Werte. | Senden Sie rohes JSON in UTF-8 mit dem Header Content-Type: application/json. Prüfen Sie die Werte. |
| 2 | Invalid Service Tag ID | Der Query-Parameter stgid passt zu keinem registrierten Gerät. | Kopieren Sie die Service Tag ID erneut aus Ihrem API Monitor-Konto. |
| 3 | Invalid Request | Die Anfrage entspricht nicht dem Format dieser Operation. | Vergleichen Sie sie mit der Beispielanfrage für die Operation. |
| 4 | Invalid Encryption | Die AES-256-Nutzlast konnte nicht entschlüsselt werden. | Prüfen Sie den Verschlüsselungsschlüssel und die Base64-Kodierung. |
| 5 | Device Offline | Das Zielgerät ist derzeit nicht mit Cams verbunden. | Prüfen Sie die Seite Device Status. Der Befehl wird in die Warteschlange gestellt und zugestellt, sobald sich das Gerät wieder verbindet. |
| 6 | Operation Timeout | Das Gerät hat den Befehl nicht rechtzeitig bestätigt. | Prüfen Sie, ob das Gerät online ist, und versuchen Sie es erneut. |
| 7 | Invalid Auth Token | Der AuthToken stimmt nicht mit dem für das Gerät festgelegten überein. | Verwenden Sie den 32-stelligen Token aus dem API Monitor. |
| 8 | User Already Exists | Es wurde versucht, eine UserID hinzuzufügen, die bereits auf dem Gerät vorhanden ist. | Aktualisieren Sie stattdessen den Benutzer oder löschen Sie ihn zuerst. |
| 9 | User Not Found | Die UserID ist nicht auf dem Gerät vorhanden. | Prüfen Sie die UserID. Fügen Sie den Benutzer bei Bedarf zuerst hinzu. |
| 10 | Template Error | Das biometrische Template ist beschädigt oder hat ein nicht unterstütztes Format. | Prüfen Sie die Base64-Daten, die Size und den Index des Templates. |
| 11 | Device Memory Full | Das Gerät hat sein Limit an Benutzern oder Templates erreicht. | Löschen Sie nicht mehr benötigte Benutzer oder Templates. |
| 13 | Invalid Security Key | Der Security Key stimmt nicht mit dem im API Monitor überein. | Verwenden Sie auf beiden Seiten denselben Schlüssel. |
| 15 | Feature Not Supported | Dieses Gerätemodell oder dieser Verbindungsmodus unterstützt die Operation nicht. | Prüfen Sie den Verbindungsmodus. Die Modi DB Pull und File Processing unterstützen nur Attendance Push, keine RESTful-Befehle. |
| 999 | Unknown Error | Ein unerwarteter Fehler. | Kontaktieren Sie den Cams-Support und nennen Sie die OperationID. |
Tipps
- Erzeugen Sie für jede REST-Anfrage eine eindeutige OperationID. Die Antwort wiederholt sie, sodass Sie Anfrage und Antwort zuordnen können.
- REST-Befehle brauchen etwa 15 Sekunden, bis sie das Gerät erreichen.
- Die Codes 12 und 14 werden nicht verwendet.
Siehe auch: Callback URL not receiving data, Add or delete users in bulk.
Brauchen Sie Hilfe? Schreiben Sie eine E-Mail an support@camsbiometrics.com mit der OperationID und dem StatusCode.
Was this article helpful?