事例:1台のデバイスから複数のサーバーへ勤怠データを送信
要件
あるお客様は生体認証デバイスを1台だけ使用していましたが、その勤怠データを2つの別々のソフトウェアシステムに送信する必要がありました。たとえば、社内の人事システムと、外部の給与計算ベンダーのシステムです。2台目のデバイスを設置することも、1台のハードウェアを両システムで分け合うことも避けたいというご要望でした。
デュアルAPIの考え方が適している理由
通常、1台のデバイスは1つのAPIと1つのコールバックURLに対応付けられ、すべての打刻データは単一の送信先に送られます。デュアルAPIの構成では、この1対1の制限を取り除きます。ハードウェアを追加する代わりに、お客様は同じ物理デバイスに対して追加のAPIライセンスを購入します。各APIにはそれぞれ独自のコールバックURLが割り当てられ、デバイスは設定されたすべてのURLへ勤怠データを同時に送信します。順番に送るのでも、遅延させるのでもありません。
これにより、お客様はドアに2台のデバイスを設置する必要も、2回の登録作業を行う必要も、2セットのハードウェア保守を行う必要もなくなりました。1回の打刻、1台のデバイス、複数の送信先です。
処理の流れ
デュアルAPIの流れ:1回の打刻データを、設定された2つのコールバックURLへ同時に送信
- ユーザーは通常どおりデバイスで打刻します。エンドユーザーの操作に変更はありません。
- デバイスには2つ(またはそれ以上)の設定済みAPIがあり、それぞれが独自のコールバックURLを指定しています。
- 勤怠データは、設定されたすべてのURLへ同時に送信されます。
- 受信した各サーバーやソフトウェアは、そのデータを独立して処理します。一方が他方の応答に依存することはありません。
2つを超える構成への拡張
この構成は送信先を2つに限定されるものではありません。同じ考え方を1台のデバイスに対するn個のAPIに拡張できます。追加のAPIはそれぞれ独自のコールバックURLを持つシャドウAPIとなり、デバイスはそれらすべてへ同時に送信します。たとえば、勤怠データを人事、給与計算、コンプライアンス用ダッシュボードへ同期するお客様は、3台のリーダーを設置する代わりに、1台のデバイスに3つのAPIを設定できます。
購入時に必要な内容
|
デバイスの1つ目のAPI
|
追加のAPI(シャドウAPI)ごと
既存のユニットを再利用するため、デバイス費用は発生しません。 |
導入時の注意事項
- 各API/コールバックURLの組は独立して動作します。1つのコールバックURLで障害が発生したり応答が遅くなったりしても、他の送信先への配信がブロックされたり遅延したりすることはありません。
- 配信は、あるサーバーが次のサーバーへ中継する方式ではなく同時に行われるため、受信システム間で管理すべき依存関係はありません。
- この方式は、2つのシステムが互いに通信する必要はなく、異なる目的(たとえば給与計算と入退室ログ)で同じ生の勤怠データを必要とする場合に効果的です。
- 各APIとそのコールバックURLは、ダッシュボードから個別に設定します。シャドウAPIを追加しても、デバイス本体の再設定は不要です。
- 各シャドウAPIへの配信は、API Monitorを使用して個別に確認してください。1つのコールバックURLで配信の問題が発生しても、他のURLには表示されないことがあるためです。
- 送信先が完全に独立しているため、デュアルAPIは移行作業を並行して進める方法としても適しています。新しいシステムを検証している間も既存のシステムでデータを受信し続け、切り替えに確信が持てた段階で古いコールバックURLを廃止できます。
結果
お客様は、既存の1台のデバイスを使用して2つの送信先の要件を満たすことができました。2台目のユニットに伴うコストと複雑さを避けられています。導入では、2つ目の送信先のためのAPIライセンスの追加購入のみが必要となり、デバイス費用は1回分のみ発生しました。