HTTPリクエスト
HTTP/HTTPS リクエストをターゲットの外部デバイスまたはシステム (投光器スイッチ、アクセス制御実行、警報システム)に送信すると、これらのデバイスやシステムで使用して追加のアクションを実行できます。
リクエストは、受信デバイスで読み込まれるために適切なフォーマットに従う必要があります。HTTPS URL がサポートされます。
Nx Witness で実行されたイベントに応答するために、このアクションは HTTP GET、POST、PUT、または削除リクエストを生成します。
HTTP リクエストをイベントとして受信できる「一般的なイベント」とともに、Nx Witness と他のソフトウェアシステムの間に双方向の API 通信を作成できます。
例えば、製造業者はエントリポイントにおいて ACS カードリーダーおよびそのエントリポイント周辺エリアを監視するカメラを備えた制限エリアを持ちます。
Nx Witness は、エントリエリアで異常な期間の動作が検出された場合に通知を送信する一般的なルールを持ちます。
何者かが不正な試みでカードリーダーを改ざんして制限エリアへの侵入を試みた場合、Nx
Witness はアクションを 1 つ実行して動作が制限エリアで検出されたことを監視センターに通知し、2 番目の HTTP リクエストアクションを製造業者のコールセンターのサーバーへ送信します。
そうすることによって、セキュリティ手順が実行されてアラームがアクティブ化され、工場のセキュリティ担当者に電話が発信されます。
例
http://123.12.8.1:7001/api.clickandcall.com/http/sendmsg?user=WitnessVMS&password=123456&api_id=3612726$MO=1&from-13234567890&to=18184493546$text=Visitor+is+outside+front+door.
この例では、APIリクエストをクリックアンドコールシステムに送信して、SMS メッセージを指定した電話番号に送信します。
例えば、第三者のデバイスを実行できる一般的なイベントと結合して、正面玄関の鍵を開けることができます。
-
sendmsg – IPアドレス「123.12.8.1」でポート「7001」のサーバーにデータを送信します。
-
user/password – 受信者が必要とする認証情報で、リクエストがシステムへアクセス可能となります。
-
api_id – 受信エンティティで必要なアカウント番号。
-
from – メッセージの送信元となる電話番号。
-
to – メッセージの送信先となる電話番号。
-
text – メッセージテキスト。この場合、"Visitor is outside front door"。
基本のパラメーター
- アクションインターバル – このボックスを選択して、アクションが実行される回数を集計します。
整数を入力して、メニューから期間("秒"、"分"、"時"、または"日")を選択します。選択解除して、イベントが発生するたびにアクションを実行します。
- HTTP URL – リクエストを受信する外部システムへの HTTP リンク。リクエスト自身を含むことも可能。
- HTTP コンテンツ– 必要に応じて、HTTPリクエストの本文。
- ログイン および パスワード – 外部システムが必要とする場合、認証のために資格情報を入力します。
- コンテンツタイプ – リクエストの本文を入力します。受信システムの要件に応じて、"自動"、"text/plain"、"text/html"、"application/html"、"application/json"、または"application/xml"のフォーマットから選択します。
"自動"はお客様のエントリに合わせて最適なフォーマットを選択します。
- 認証タイプ – 必要な認証のレベル ("自動"または"ベーシック")。
- 要求のタイプ – リクエストのタイプ ("自動"、 "GET"、"POST"、"PUT"、または"DELETE")。
アクションが不正に動作する理由
イベントが適切に設定されていません。
HTTP リクエスト構文が不適切であるか、受信者の要件を満たしません。
外部システムは認証を必要とし、認証情報が指定されていないか、正しくありません。