1 / 1

2.2 デバイスの API

2.2.1 ゲートウェイの追加 (/api/v3/gateway/add)

開発中のため当APIは現在利用できません

概要

ゲートウェイデバイスを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v3/gateway/add

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"id": 1561,
		"name": "SNB",
		"location": "306",
		"direction": 0,
		"description":"",
		"ldid": "SNB-2ee63f9c699a7316a3e2a44646d0c844",
		"type_id": 10,
		"type_name": "SNB",
		"update_at": 1574854584,
		"create_at": 1574670842
	}
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.2 カメラの追加 (/api/v3/camera/add)

開発中のため当APIは現在利用できません。

概要

カメラを追加します。事前にゲートウェイデバイスを追加する必要があります。

リクエストアドレスの例

https://HOST:PORT/api/v3/camera/add

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 1562,
 "name": "40F",
 "location": "40F",
 "description": "",
 "direction": 0,
 "ldid": "CAM-b054ac85cb84137b75abaa2bd7fc4a38",
 "type_id": 11,
 "type_name": "CAM",
 "update_at": 1574851340,
 "create_at": 1574851340
 }
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.3 デバイスの更新 (/api/v3/device/update)

概要

デバイス情報を更新します（ゲートウェイデバイスはグループに連携できません）。

v1 インターフェースを引き続きご利用いただくこともできます。詳細な手順については、過去のバージョンのマニュアルをご参照ください。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/update

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": {
        "id": 2,
        "name": "勤務グループ ",
        "location": "日本東京都千代田区",
        "state": 0,
        "description": "",
        "direction": 1,
        "ip": "",
        "ldid": "SHL-3931ff3bd1fd7157866c4d22858c533c",
        "type_id": 1,
        "type_name": "SenseHello",
        "user_group": [{
            "id": 1,
            "name": "Default group",
            "type": 1,
            "devices": [],
            "is_default": 1,
            "person_count": 19988
        }],
        "guest_group": [ {
            "id": 105,
            "name": "test",
            "type": 2,
            "devices": [],
            "is_default": 0,
            "person_count": 5
        }],
        "blacklist_group": [ {
            "id": 148,
            "name": "User_1560842344639",
            "type": 5,
            "devices": [],
            "is_default": 0,
            "person_count": 23
        }],
        "update_at": 0,
        "create_at": 0,
        "last_offline_time":0
    }
}

レスポンスのフィールド

dataフィールドの説明

group フィールドの説明

エラーレスポンスのフィールド

2.2.4 デバイスの削除 (/api/v3/device/delete)

概要

デバイス（ゲートウェイまたはカメラデバイス）を削除します。

v1 インターフェースを引き続きご利用いただくこともできます。詳細な手順については、過去のバージョンのマニュアルをご参照ください。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/delete

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "desc": "",
 "data": {}
}

レスポンスのフィールド

エラーレスポンスのフィールド

2.2.5 サブカメラのリストの取得 (/api/v3/gateway/cameraList)

開発中のため、当APIは現在利用できません

概要

カメラのリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/gateway/cameraList

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": [{
        "id":1562
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "channel": 2,
        "position": "",
        "url": "172.20.4.110",
        "state": 1,
        "camera_sn": "CAM-51b4ef5a2a4949d5a2e329aecd56b7ff",
        "camera_name": "2"
    }, {
        "id":1563
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "channel": 1,
        "position": "",
        "url": "172.20.4.110",
        "state": 1,
        "camera_sn": "CAM-525747229d7f3994caa9e595f72fcfdb",
        "camera_name": "1"
    }]
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.6 親デバイスの取得 (/api/v3/camera/gatewayList)

開発中のため、当APIは現在利用できません。

概要

関連する親デバイスを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/camera/gatewayList

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": {
        "id":1561,
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "name": "306",
        "location": "306",
        "host": "172.20.4.110",
        "port": 80,
        "cameras": [{
            "id":1562,
            "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
            "channel": 1,
            "position": "",
            "url": "172.20.4.110",
            "camera_sn": "CAM-525747229d7f3994caa9e595f72fcfdb",
            "camera_name": "1"
        }, {
            "id":1563,
            "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
            "channel": 2,
            "position": "",
            "url": "172.20.4.110",
            "camera_sn": "CAM-51b4ef5a2a4949d5a2e329aecd56b7ff",
            "camera_name": "2"
        }]
    }
}

レスポンスのフィールド

dataフィールドの説明

cameraフィールドの説明

エラーレスポンスのフィールド

2.2.7 デバイスリストの表示 (/api/v1/device)

概要

デバイスリストを表示します。デフォルトの順序は ID の降順です。

リクエストアドレスの例

https://HOST:PORT/api/v1/device

リクエスト方法

GET

リクエストパラメーター

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"total": 406,
		"pageNum": 1,
		"size": 20,
		"pageSize": 20,
		"totalPage": 21,
		"data": [{
			"device_type": {
			  "id": 2,
				"name": "SenseID",
				"identifier": "SID",
				"description": "SenseID",
				"create_at": "2018-08-15 10:08:12.0",
				"update_at": "2018-08-15 10:08:15.0"
			},
			"device": {
				"id": 31,
				"sn": "SID-5f51f769de2cdc8681e85ad590456516",
				"name": "306 テスト用デバイス",
				"direction": 0,
				"location": "306",
				"ip": null,
				"status": 2,
				"groups": [{
					"id": 2,
					"name": "Default group",
					"type": 2
				}],
				"active": 1,
				"type_id": 2,
				"description": null,
				"software_version": null,
				"info": null,
				"company_id": 1,
				"group_count": 1,
				"create_at": "2019-03-20 09:50:08.0",
				"update_at": "2019-08-28 08:56:05.0"
			}
		}]
	}
}

レスポンスのフィールド

dataフィールドの説明

data.dataフィールドの説明

device_type フィールドの説明

device フィールドの説明

group フィールドの説明

エラーレスポンスのフィールド

2.2.8 リモート構成（一括複数アップデート）(/api/v2/device/update/config/batch)

概要

同じタイプのオンラインデバイスに対してリモート構成コマンドを送信します。一括送信に対応しています。

現在、下記のデバイスをサポートしています。SensePass、SenseThunder GE、SenseThunder Mini GE。

この機能をサポートするデバイスの最低バージョンは、SensePass（v1.2.3）、SenseThunder GE （v1.0.3）、SenseThunder Mini GE （v1.0.1）。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/update/config/batch

リクエスト方法

POST application/json

リクエストパラメーター

デバイス型番識別子

構成項目とパラメーターの説明

リクエスト例

{
    "device_ids": [
        3
    ],
    "sps": {
        "device_run_type": 1,
        "use_mode": 1,
        "mode": 1,
        "welcome_tip": "welcomeTip22222222",
        "verify_success_tip": "verifySuccessTip",
        "verify_fault_tip": "verifyFaultTip",
        "show_user_info": "00100",
        "liveness": true,
        "liveness_threshold": 0.95,
        "verify_threshold": 0.9,
        "face_width": 300,
        "open_door_type": 1,
        "keep_door_open_duration": 10,
        "gpio_a": 1,
        "gpio_b": 1,
        "gpio_c": 1,
        "buzzer_status": true,
        "language_type": 1,
        "auto_reboot": false,
        "reboot_time": "09:52:50",
        "standby_open": false,
        "wait_time": 10,
        "recognition_distance": 1.5,
        "wigan_input": 1,
        "network_relay_address": "",
        "open_interval": 5,
        "use_show_avatar": true
    }
}

通常のレスポンス

{
  "code": 200,
  "message": "OK"
}

エラーレスポンスのフィールド

2.2.9 リモートドアオープン (/api/v2/device/open)

概要

オンラインデバイスにドアオープンコマンドを送信します。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/open

リクエスト方法

POST: form-data

リクエストパラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": ""
}

エラーレスポンスのフィールド

2.2.10 通知の送信 (/api/v3/device/notify)

開発中のため当APIは現在利用できません

概要

オンラインデバイスに通知メッセージを送信します。カスタマイズコマンドに対応しています。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/notify

リクエスト方法

POST application/json

リクエストパラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": ""
}

エラーレスポンスのフィールド

リクエスト例

2.2.11 デバイスLDIDの取得（/api/v3/device/ldid）

概要

デバイスのシリアル番号でデバイスのLDIDを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/ldid

リクエスト方法

GET

リクエストパラメーター

デバイス型番識別子

レスポンスのフィールド

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    " data": " SPS-c725f19ddf7d5d9fabee189c29f10b11"
}

2.2 デバイスの API

2.2.1 ゲートウェイの追加 (/api/v3/gateway/add)

開発中のため当APIは現在利用できません

概要

ゲートウェイデバイスを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v3/gateway/add

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"id": 1561,
		"name": "SNB",
		"location": "306",
		"direction": 0,
		"description":"",
		"ldid": "SNB-2ee63f9c699a7316a3e2a44646d0c844",
		"type_id": 10,
		"type_name": "SNB",
		"update_at": 1574854584,
		"create_at": 1574670842
	}
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.2 カメラの追加 (/api/v3/camera/add)

開発中のため当APIは現在利用できません。

概要

カメラを追加します。事前にゲートウェイデバイスを追加する必要があります。

リクエストアドレスの例

https://HOST:PORT/api/v3/camera/add

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 1562,
 "name": "40F",
 "location": "40F",
 "description": "",
 "direction": 0,
 "ldid": "CAM-b054ac85cb84137b75abaa2bd7fc4a38",
 "type_id": 11,
 "type_name": "CAM",
 "update_at": 1574851340,
 "create_at": 1574851340
 }
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.3 デバイスの更新 (/api/v3/device/update)

概要

デバイス情報を更新します（ゲートウェイデバイスはグループに連携できません）。

v1 インターフェースを引き続きご利用いただくこともできます。詳細な手順については、過去のバージョンのマニュアルをご参照ください。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/update

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": {
        "id": 2,
        "name": "勤務グループ ",
        "location": "日本東京都千代田区",
        "state": 0,
        "description": "",
        "direction": 1,
        "ip": "",
        "ldid": "SHL-3931ff3bd1fd7157866c4d22858c533c",
        "type_id": 1,
        "type_name": "SenseHello",
        "user_group": [{
            "id": 1,
            "name": "Default group",
            "type": 1,
            "devices": [],
            "is_default": 1,
            "person_count": 19988
        }],
        "guest_group": [ {
            "id": 105,
            "name": "test",
            "type": 2,
            "devices": [],
            "is_default": 0,
            "person_count": 5
        }],
        "blacklist_group": [ {
            "id": 148,
            "name": "User_1560842344639",
            "type": 5,
            "devices": [],
            "is_default": 0,
            "person_count": 23
        }],
        "update_at": 0,
        "create_at": 0,
        "last_offline_time":0
    }
}

レスポンスのフィールド

dataフィールドの説明

group フィールドの説明

エラーレスポンスのフィールド

2.2.4 デバイスの削除 (/api/v3/device/delete)

概要

デバイス（ゲートウェイまたはカメラデバイス）を削除します。

v1 インターフェースを引き続きご利用いただくこともできます。詳細な手順については、過去のバージョンのマニュアルをご参照ください。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/delete

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "desc": "",
 "data": {}
}

レスポンスのフィールド

エラーレスポンスのフィールド

2.2.5 サブカメラのリストの取得 (/api/v3/gateway/cameraList)

開発中のため、当APIは現在利用できません

概要

カメラのリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/gateway/cameraList

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": [{
        "id":1562
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "channel": 2,
        "position": "",
        "url": "172.20.4.110",
        "state": 1,
        "camera_sn": "CAM-51b4ef5a2a4949d5a2e329aecd56b7ff",
        "camera_name": "2"
    }, {
        "id":1563
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "channel": 1,
        "position": "",
        "url": "172.20.4.110",
        "state": 1,
        "camera_sn": "CAM-525747229d7f3994caa9e595f72fcfdb",
        "camera_name": "1"
    }]
}

レスポンスのフィールド

dataフィールドの説明

エラーレスポンスのフィールド

2.2.6 親デバイスの取得 (/api/v3/camera/gatewayList)

開発中のため、当APIは現在利用できません。

概要

関連する親デバイスを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/camera/gatewayList

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": "",
    "data": {
        "id":1561,
        "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
        "name": "306",
        "location": "306",
        "host": "172.20.4.110",
        "port": 80,
        "cameras": [{
            "id":1562,
            "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
            "channel": 1,
            "position": "",
            "url": "172.20.4.110",
            "camera_sn": "CAM-525747229d7f3994caa9e595f72fcfdb",
            "camera_name": "1"
        }, {
            "id":1563,
            "sn": "SNB-4828af35b4c652a4dd34f6736ef6c110",
            "channel": 2,
            "position": "",
            "url": "172.20.4.110",
            "camera_sn": "CAM-51b4ef5a2a4949d5a2e329aecd56b7ff",
            "camera_name": "2"
        }]
    }
}

レスポンスのフィールド

dataフィールドの説明

cameraフィールドの説明

エラーレスポンスのフィールド

2.2.7 デバイスリストの表示 (/api/v1/device)

概要

デバイスリストを表示します。デフォルトの順序は ID の降順です。

リクエストアドレスの例

https://HOST:PORT/api/v1/device

リクエスト方法

GET

リクエストパラメーター

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"total": 406,
		"pageNum": 1,
		"size": 20,
		"pageSize": 20,
		"totalPage": 21,
		"data": [{
			"device_type": {
			  "id": 2,
				"name": "SenseID",
				"identifier": "SID",
				"description": "SenseID",
				"create_at": "2018-08-15 10:08:12.0",
				"update_at": "2018-08-15 10:08:15.0"
			},
			"device": {
				"id": 31,
				"sn": "SID-5f51f769de2cdc8681e85ad590456516",
				"name": "306 テスト用デバイス",
				"direction": 0,
				"location": "306",
				"ip": null,
				"status": 2,
				"groups": [{
					"id": 2,
					"name": "Default group",
					"type": 2
				}],
				"active": 1,
				"type_id": 2,
				"description": null,
				"software_version": null,
				"info": null,
				"company_id": 1,
				"group_count": 1,
				"create_at": "2019-03-20 09:50:08.0",
				"update_at": "2019-08-28 08:56:05.0"
			}
		}]
	}
}

レスポンスのフィールド

dataフィールドの説明

data.dataフィールドの説明

device_type フィールドの説明

device フィールドの説明

group フィールドの説明

エラーレスポンスのフィールド

2.2.8 リモート構成（一括複数アップデート）(/api/v2/device/update/config/batch)

概要

同じタイプのオンラインデバイスに対してリモート構成コマンドを送信します。一括送信に対応しています。

現在、下記のデバイスをサポートしています。SensePass、SenseThunder GE、SenseThunder Mini GE。

この機能をサポートするデバイスの最低バージョンは、SensePass（v1.2.3）、SenseThunder GE （v1.0.3）、SenseThunder Mini GE （v1.0.1）。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/update/config/batch

リクエスト方法

POST application/json

リクエストパラメーター

デバイス型番識別子

構成項目とパラメーターの説明

リクエスト例

{
    "device_ids": [
        3
    ],
    "sps": {
        "device_run_type": 1,
        "use_mode": 1,
        "mode": 1,
        "welcome_tip": "welcomeTip22222222",
        "verify_success_tip": "verifySuccessTip",
        "verify_fault_tip": "verifyFaultTip",
        "show_user_info": "00100",
        "liveness": true,
        "liveness_threshold": 0.95,
        "verify_threshold": 0.9,
        "face_width": 300,
        "open_door_type": 1,
        "keep_door_open_duration": 10,
        "gpio_a": 1,
        "gpio_b": 1,
        "gpio_c": 1,
        "buzzer_status": true,
        "language_type": 1,
        "auto_reboot": false,
        "reboot_time": "09:52:50",
        "standby_open": false,
        "wait_time": 10,
        "recognition_distance": 1.5,
        "wigan_input": 1,
        "network_relay_address": "",
        "open_interval": 5,
        "use_show_avatar": true
    }
}

通常のレスポンス

{
  "code": 200,
  "message": "OK"
}

エラーレスポンスのフィールド

2.2.9 リモートドアオープン (/api/v2/device/open)

概要

オンラインデバイスにドアオープンコマンドを送信します。

リクエストアドレスの例

https://HOST:PORT/api/v2/device/open

リクエスト方法

POST: form-data

リクエストパラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": ""
}

エラーレスポンスのフィールド

2.2.10 通知の送信 (/api/v3/device/notify)

開発中のため当APIは現在利用できません

概要

オンラインデバイスに通知メッセージを送信します。カスタマイズコマンドに対応しています。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/notify

リクエスト方法

POST application/json

リクエストパラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "desc": ""
}

エラーレスポンスのフィールド

リクエスト例

2.2.11 デバイスLDIDの取得（/api/v3/device/ldid）

概要

デバイスのシリアル番号でデバイスのLDIDを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/device/ldid

リクエスト方法

GET

リクエストパラメーター

デバイス型番識別子

レスポンスのフィールド

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    " data": " SPS-c725f19ddf7d5d9fabee189c29f10b11"
}