Support Hub/API & Integrations/API-Statuscodes: Bedeutung der Fehler und ihre Behebung
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.

CodeStatusBedeutungWas zu tun ist
0SuccessDer Vorgang wurde abgeschlossen.Nichts.
1Invalid Request DataDer 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.
2Invalid Service Tag IDDer Query-Parameter stgid passt zu keinem registrierten Gerät.Kopieren Sie die Service Tag ID erneut aus Ihrem API Monitor-Konto.
3Invalid RequestDie Anfrage entspricht nicht dem Format dieser Operation.Vergleichen Sie sie mit der Beispielanfrage für die Operation.
4Invalid EncryptionDie AES-256-Nutzlast konnte nicht entschlüsselt werden.Prüfen Sie den Verschlüsselungsschlüssel und die Base64-Kodierung.
5Device OfflineDas 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.
6Operation TimeoutDas Gerät hat den Befehl nicht rechtzeitig bestätigt.Prüfen Sie, ob das Gerät online ist, und versuchen Sie es erneut.
7Invalid Auth TokenDer AuthToken stimmt nicht mit dem für das Gerät festgelegten überein.Verwenden Sie den 32-stelligen Token aus dem API Monitor.
8User Already ExistsEs 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.
9User Not FoundDie UserID ist nicht auf dem Gerät vorhanden.Prüfen Sie die UserID. Fügen Sie den Benutzer bei Bedarf zuerst hinzu.
10Template ErrorDas 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.
11Device Memory FullDas Gerät hat sein Limit an Benutzern oder Templates erreicht.Löschen Sie nicht mehr benötigte Benutzer oder Templates.
13Invalid Security KeyDer Security Key stimmt nicht mit dem im API Monitor überein.Verwenden Sie auf beiden Seiten denselben Schlüssel.
15Feature Not SupportedDieses 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.
999Unknown ErrorEin 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?