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