Translated from the English article and reviewed by a person. Read the English original
Fix
コールバック URL がデータを受信しない場合のチェックリスト
打刻がコールバック URL に届かない場合は、次の項目を順番に確認してください。
- デバイスは Cams に到達していますか? Device Status ページを開きます。デバイスがオフラインの場合は、デバイスがオフライン表示になる理由を参照してください。
- URL は正しいですか? API Monitor アカウントに保存されているコールバック URL を確認します。
- サーバーは正しく応答していますか? 自サーバーの処理が失敗した場合でも、常に
{"status":"done"}と HTTP ステータス 200 で応答してください。負荷の高い処理は後でキューに入れて行い、Cams を待たせないようにします。 - エンドポイントはインターネットから到達可能ですか? 本番環境ではポート 80(HTTP)または 443(HTTPS)を使用してください。ポート 8123 はテスト専用です。これらのポートをファイアウォールで許可してください。
- HTTPS は正しく設定されていますか? ポート 443 で有効な SSL 証明書を使った HTTPS に対応しており、推奨されます。サーバーを再起動しなくても証明書が更新されるようにしてください。
- ボディを raw JSON として読み取っていますか? リクエストは、フォームフィールドではなく、UTF-8 の raw JSON です。
- AuthToken のチェックは正しいですか? 各コールバックには AuthToken が含まれます。API Monitor に設定されたトークンと比較し、一致しない場合は拒否してください。誤ったトークンと比較して、正常なリクエストを拒否していないか確認してください。
- 暗号化が有効になっていませんか? API Monitor に Security Key が設定されている場合、ペイロードは暗号化されます。サーバー側で同じキーを使って復号する必要があります。暗号化を使うつもりがない場合は、キーを削除してください。
- 配信が一時停止していませんか? サーバーが想定外の応答を返した場合、配信は最大3回試行された後に一時停止し、3時間ごとに再試行されます。サーバーを修正し、Device Status ページからキューを再開してください。打刻が送信されない・キューに溜まる場合を参照してください。
テスト方法
- Postman または cURL で、URL にテスト用の POST を送信します。
- 自分のコンピューターからテストするには、ngrok などのトンネルを使います。ローカル環境からコールバック URL をテストするを参照してください。
- 受信側を構築するには、生体認証コールバックレシーバーの構築を参照してください。
配信できなかったイベントは保持され、サーバーが復旧すると送信されます。オフライン中の打刻についてを参照してください。
解決しない場合は、support@camsbiometrics.com まで、デバイスのシリアル番号と問題の簡単な説明をメールでお送りください。
Was this article helpful?