概要

この記事では、Postman ツールを使用して、HTTP API を通じて VS133-P/VS135-P のレポートデータを取得する方法について説明します。

必要条件

• Milesight VS135 バージョン 1.0.9 以上、または VS133 バージョン 1.0.9-r2 以上
• Postman ソフトウェア
• Windows 搭載のコンピュータ

設定

手順 1. 公式サイトから最新の API インターフェースドキュメントをダウンロードします

vs13x-api-documentation-en

手順 2. Postman をダウンロードし、API の呼び出し方法を学習します

まず、ブラウザから以下のリンクから Postman ソフトウェアをダウンロードしてインストールしてください：

https://www.postman.com/downloads/

Postmanを開き、 File > New > HTTP をクリックしてAPIワークベンチを作成します。そして、リクエストタイプをPOSTに変更します。

Authorization モジュールでDigest Authを選択し、VS133-P/VS135-PのWebユーザー名とWebパスワードを入力します。

Body、rawモジュールを選択し、リクエスト内容を記入します。そして、POSTに呼び出すインターフェースを記入します。

ステップ 3：レポートデータの取得
使用するインターフェース：

http://192.168.45.72/api/v1/counting/getDatabseRecords

http://192.168.45.72/api/v1/counting/getRecordsResult

呼び出し内容は、前述のAPIユーザーガイドを参照してください。また、Webデバッグインターフェースから直接取得することも可能です。ここでは、Webページからの取得方法を例に説明します

まず、VS13XのWebインターフェースにログインし、F12をクリックしてブラウザのデバッグインターフェースを開きます。「Report > Network」を選択してインターフェースを表示します。

 “getDatabseRecords” > “Payload” > “View source”,をクリックすると、このクエリのインターフェース内容をすべて確認し、コピーすることができます。

まず、getDatabseRecordsインターフェースを呼び出す必要があります。その際、実際のデータクエリの範囲を選択し、任意の一意のUUIDを使用する必要があります

Webページから取得したUUIDがすでに一度呼び出されている場合は、手動で未呼び出しのものに変更する必要があります。例えば、UUIDをランダムに新しい値に変更します。ただし、2つのインターフェースのUUIDが同じであることを確認してください。

{「event」:0,「timeStart」:「2025-06-30T13:00:00.000」,『timeEnd』:「2025-07-01T13:00:00.000」,” lineParam「:{」line「:1,」timeUnit「:0,」mode「:0},」regionCounting「:{」regionID「:0,」mode「:0},」dwellDetct「:{」regionID「:0,」timeMin「:10,『timeBinWidth』:10,」 numOfBins「:10},」heatmap「:{」type「:0},『uuid』:」65f42ffb-1d49-4466-b772-43d6b9a00ed2″}

getRecordsResultB インターフェースを呼び出すための新しいPOSTページを作成します。この際、同じUUIDを使用する必要があります。そうすることで、その時刻に対応するデータを取得できます。

{「uuid」:「65f42ffb-1d49-4466-b772-43d6b9a00ed2」,「event」:0}

注： UUIDによる呼び出しが完了した後、再度クエリが必要な場合は、新しいUUIDを使用して手順3をもう一度実行する必要があります。また、timeStartとtimeEndは実際の時刻に変更可能です。リクエスト内容の具体的な形式については、手順1のAPIドキュメントを参照してください。

——-以上—–