Cams Biometric Gateway — Web API 3.0
The Cams Biometric Gateway is the universal Biometric API that connects any biometric attendance or access control machine with your application — ERP, HRMS, payroll, school management, custom software, or AI/automation workflow. It supports all major device brands and provides a standardised JSON-over-HTTP Biometric API regardless of the hardware.
仕組み
Biometric Gateway は次の要素で構成されます。
連携先
| API の種類 | 方向 | レイテンシ | 用途 |
|---|---|---|---|
| コールバック API | 機器 → お客様のサーバー | リアルタイム / 遅延なし | 勤怠打刻やユーザー同期イベントの受信 |
| RESTful API | お客様のサーバー → 機器 | 約 15 秒 | ユーザーの追加／削除、ログの取得、生体データの登録 |
導入手順
3 つのステップで連携できます。コールバックを受信するため、お客様のサーバーには外部から到達可能な URL が必要です。
コールバック URL を設定する
API Monitor ポータルにログインし、お客様のサーバーの公開 HTTPS URL を機器のコールバック URL として設定します。API エンジンは生体認証イベントをこのエンドポイントにリアルタイムで POST します。
勤怠打刻を受信する
エンドポイントは raw JSON ボディの POST を受信します。コールバック API ではクエリパラメータは不要です。AuthToken を検証し、打刻データを解析して、{"status":"done"} を返してください。
RESTful API を呼び出してユーザーと機器を管理する
API Monitor アカウントに表示されている RESTful エンドポイント URL に、stgid（Service Tag ID）をクエリパラメータとして付けて JSON コマンドを POST します。エンジンはコマンドをキューに入れ、機器は約 15 秒以内に応答します。
エンドポイント形式
| API の種類 | メソッド | 送信方法 |
|---|---|---|
| コールバック API（受信） | POST | 機器がお客様が設定した URL に POST します。raw JSON ボディで、パラメータはありません。 |
| RESTful API（送信） | POST | RESTful エンドポイント URL（API Monitor アカウントに記載）に、?stgid=YOUR_SERVICE_TAG_ID と raw JSON ボディを付けて POST します。 |
{"status":"done"}（HTTP 200）を返す必要があります。応答前に重い処理を行わず、キューに入れてください。
API ドキュメント
リファレンスはトピック別に分かれています。まず機器の互換性を確認し、次にコールバックと REST の操作をご覧ください。
お問い合わせ
API サポート、機器の互換性、お見積りに関するお問い合わせ：
営業 & サポート
開発者向けリソース
Cams Biometrics（Dheeram Innovations Pvt Ltd） — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, India.