SK VMS User Manual
外部デバイスまたはシステム (照明投光スイッチ、アクセスコントロールトリガー、警報システム 等) でのアクションをトリガーするために、HTTP/HTTPS リクエストを対象に送信します。リクエストは、受信側デバイスで読み取れる正しいフォーマットに従う必要があります。
このアクションは、SK VMS でトリガーされたイベントに応答して、HTTP GET、POST、PUT、PATCH、DELETE リクエストを生成します。イベントとしてHTTPリクエストを受信できる「汎用イベント」と併用することで、SK VMS と他のソフトウェアシステムとの間で双方向 API 通信を作成できます。
たとえばある工場で、入口に ACS カードリーダーおよび周辺を監視するカメラがある立入制限区域があるとします。SK VMS には、入口で異常な継続時間のモーションが検知された場合に通知を送信するイベントルールが設定されています。誰かが制限区域に侵入しようとしてカードリーダーの不正操作を試みた場合、SK VMS は、エリア内でモーションが検知されたことを監視センターに通知するアクションと、メーカーのコールセンターサーバーへのHTTPリクエストアクションをトリガーします。これにより警報が作動し、工場のセキュリティ担当者が呼び出されます。
実行例
http://123.12.8.1:7001/api.clickandcall.com/http/sendmsg?user=VMSuser&password=123456&api_id=3612726$MO=1&from-13234567890&to=18184493546$text=Visitor+is+outside+front+door
この例では、指定した電話番号にSMSメッセージを送信するために、clickandcall システムにAPIリクエストを送信します。これは、たとえば汎用イベントと結合して、サードパーティーのデバイスをトリガーして玄関ドアを解錠することもできます。
•123.12.8.1:7001 – IPアドレス 123.12.8.1、ポート 7001 のサーバーにデータを送信します。
•user, password – 受信側システムでリクエストによるアクセスを許可するために必要な認証情報。
•api_id – 受信側のエンティティに必要なアカウント番号。
•from – メッセージの送信元の電話番号。
•to – メッセージの送信先の電話番号。
•text – メッセージテキスト。この例では "Visitor is outside front door" となります。
基本パラメーター
•実行間隔 – アクションがトリガーされる頻度を制限するには、このボックスにチェックを入れてください。整数を入力し、メニューから単位 (『秒』『分』『時間』『日』) を選択してください。チェックを外すと、イベントが発生するたびにアクションがトリガーされます。
•HTTP(S) URL – リクエストを受け取る外部システムへのHTTPリンク。リクエスト自体を含めることもできます。
•HTTP(S)コンテンツ – 必要に応じて指定する、HTTPリクエストボディ。適切なイベントデータに自動的に置き換わるパラメーターについては、「イベントのフィールドプレースホルダー」をご参照ください。
•ログイン名とパスワード – 受信側システムで必要な場合、認証のための資格情報をここに入力してください。
•コンテンツタイプ – 受信側システムの要件に従って、以下のコンテンツ形式タイプから選択または手動入力してください。
o自動
otext/plain
otext/html
oapplication/html
oapplication/json
oapplication/xml
注: 自動では、入力内容に応じて最適な形式を自動選択します。
•認証タイプ – 必要とされる認証レベル (自動 または Basic)。
•リクエストメソッド – リクエストの種類。次のリクエストメソッドのいずれかを選択してください。
o自動
oGET
oPOST
oPUT
oPATCH
oDELETE
追加パラメーター
•なし
このアクションを利用可能なイベント
•すべてのイベント
アクションが正しく動作しない理由
•イベントが正しく設定されていない。
•HTTPリクエストの構文が正しくないか、受信側の要件を満たしていない。
•外部システムでは認証が必要とされるが、認証情報が指定されていない、もしくは間違っている。
•実行間隔が長すぎる。間隔を短くするか、「即時」でお試しください。
