Support Hub/API & Integrations/API ステータスコード:各エラーの意味と対処法
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 ステータスコード:各エラーの意味と対処法

RESTful API のすべてのレスポンスには、数値の StatusCode が含まれます。コード 0 は成功を意味します。コールバックのレスポンスは異なり、サーバーは常に {"status":"done"} を HTTP 200 で返します。

コードステータス意味対処法
0Successオペレーションが完了しました。対応は不要です。
1Invalid Request DataJSON ボディの形式が不正、または値が無効です。UTF-8 の raw JSON を、ヘッダー Content-Type: application/json 付きで送信してください。値を確認してください。
2Invalid Service Tag IDクエリパラメータ stgid に一致する登録済みデバイスがありません。API Monitor アカウントから Service Tag ID をもう一度コピーしてください。
3Invalid Requestリクエストがそのオペレーションの形式に従っていません。そのオペレーションのサンプルリクエストと比較してください。
4Invalid EncryptionAES-256 のペイロードを復号できませんでした。暗号化キーと Base64 エンコーディングを確認してください。
5Device Offline対象のデバイスは現在 Cams に接続されていません。Device Status ページを確認してください。コマンドはキューに入り、デバイスの再接続時に配信されます。
6Operation Timeoutデバイスが時間内にコマンドへ応答しませんでした。デバイスがオンラインか確認し、もう一度試してください。
7Invalid Auth TokenAuthToken がデバイスに設定されたものと一致しません。API Monitor に表示される32文字のトークンを使用してください。
8User Already Existsすでにデバイス上にある UserID を追加しようとしました。代わりにユーザーを更新するか、先にそのユーザーを削除してください。
9User Not Foundその UserID はデバイス上にありません。UserID を確認してください。必要であれば、先にユーザーを追加してください。
10Template Error生体認証テンプレートが破損しているか、未対応の形式です。テンプレートの Base64 データ、Size、Index を確認してください。
11Device Memory Fullデバイスのユーザー数またはテンプレート数が上限に達しました。不要なユーザーやテンプレートを削除してください。
13Invalid Security Keyセキュリティキーが API Monitor のものと一致しません。双方で同じキーを使用してください。
15Feature Not Supportedこのデバイスモデルまたは接続モードは、そのオペレーションに対応していません。接続モードを確認してください。DB Pull モードと File Processing モードは勤怠のプッシュのみに対応し、RESTful コマンドには対応していません。
999Unknown Error予期しないエラーです。Cams サポートに連絡し、OperationID を伝えてください。

ヒント

  • REST リクエストごとに一意の OperationID を生成してください。レスポンスに同じ値が返されるため、リクエストとレスポンスを対応付けられます。
  • REST コマンドがデバイスに届くまで、約15秒かかります。
  • コード 12 と 14 は使用されていません。

関連記事:コールバック URL がデータを受信しない場合、ユーザーの一括追加・削除。

お困りの場合は、support@camsbiometrics.com まで、OperationID と StatusCode をメールでお送りください。

Was this article helpful?