1 製品概要と利用方法

当製品の概要と利用方法について記載されています。

1.1 製品概要

本ドキュメントは、主に開発者の方々に利用いただくSenseLink GE EnterpriseのAPIマニュアルです。

SenseLink GE Open Platformは、SenseLink に基づくオープンサービスプラットフォームです。サードパーティのシステムはSenseLinkからデバイス、登録者、レコードなどの情報を取得し、SenseLinkが持つ管理機能をすばやく統合できます。

1.2 キーとシークレットの取得

SenseLinkにログインし、ナビゲーションメニューの[システム管理] → [Open Platform] を選択してください。AppキーとAppシークレットを管理するOpen Platform画面が表示されます。

1.2.1 キーとシークレットの作成と管理

AppキーやAppシークレットを作成するには、Open Platform画面の[App Keyを作る]ボタンをクリックしてください。このとき、確認のためにパスワードを入力する必要があります。表示される入力画面に現在ログイン中のアカウントのパスワードを入力して、確認ボタンをクリックしてください。

「AppキーとAppシークレットを作成しました。ダウンロードされたCSV内にAppキーとAppシークレットの情報が含まれます。安全に管理してください。」というメッセージが表示され、利用中のPCにAppキーとAppシークレットが記載されたCSVファイルがダウンロードされます。ダウンロードされたCSVファイルを開くと、AppキーとAppシークレットの内容を確認することができます。なお、入力したパスワードが誤っている場合、AppキーとAppシークレットは作成されず、CSVファイルもダウンロードされません。

また、Web画面上の一覧から作成したAppキーとAppシークレットを確認することができます。Appシークレットはデフォルトで非表示になっています。表示ボタンをクリックすると、パスワード入力を求められます。現在ログイン中のアカウントのパスワードを入力すると、Appシークレットが表示されます。

Appキーは5つまで作成および利用可能で、それぞれ無効化したり、削除もできます。一覧表示画面にある設定ボタンを利用することで管理できます。無効化中はAppキーとAppシークレットが利用できませんが、有効化するともう一度同じAppキーとAppシークレットが利用可能です。ただし一度削除するとAppキーとAppシークレットを復元することはできませんので、ご注意ください。

1.2.2 ドメイン管理

1.3 呼び出し方法

1.3.1 シグネチャ（sign）の計算

計算方法は、

により計算されます。タイムスタンプおよびAppシークレットを利用してください。

例：

timestamp：Unix 時間 (ミリ秒を含む13桁)

1.3.2 GET メソッドのインターフェース

sign、timestamp、および Appキー（app_key）の 3 つのパラメーターを、オプションパラメーターと共に次のようにリクエストしてください。

http://host:port/api/v1/device?typeId=10&size=100&sign=e5ef72ef839bdf5397b4906b199b9fbf&app_key=35uifanj8i30kdng&timestamp=1477881215000

TypeId および size はオプションパラメーターです。サーバーは現在の timestamp をクライアント側からのリクエスト内の timestamp と比較し、その差が30 分以上の場合はエラーを返します。

1.3.3 POST メソッドのインターフェース

sign、timestamp、およびAppキー（app_key）の 3 つのパラメーターを、次のようにリクエストしてください。

http://host:port/api/v3/device/update?sign=e5ef72ef839bdf5397b4906b199b9fbf&app_key=35uifanj8i30kdng&timestamp=1477881215000

オプションパラメーターはリクエスト本体に配置され、form-data　またはインターフェースドキュメントで指定された application/json に従って呼び出され、リクエストがサーバーへ送信されます。サーバーは現在の timestamp をクライアント側からのリクエスト内の timestamp と比較し、その差が30 分以上の場合はエラーを返します。

一部のインターフェースでは id をリクエストに配置する必要があります。詳細については、APIの利用方法をご参照ください。

1.4 API エラーコード

2.5 登録者グループの API

2.5.1 グループの追加 (/api/v1/group)

概要

グループを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v1/group

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 616,
        "name": "太朗",
        "type": 1,
        "company_id": 58,
        "create_at": "2018-08-07 18:37:32",
        "update_at": "2018-08-07 18:37:32"
    }
}

レスポンスのフィールド

dataフィールドの説明

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

2.5.2 登録者グループリストの表示 list (/api/v1/group)

概要

登録者グループのリストを表示します。デフォルトの順序はID の降順です。

リクエストアドレスの例

https://HOST:PORT/api/v1/group

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "total": 5,
        "pageNum": 1,
        "size": 5,
        "pageSize": 20,
        "totalPage": 1,
        "data": [
            {
                "id": 214,
                "name": "Default group",
                "type": 1,
                "user_number": 1327,
                "company_id": 58,
                "create_at": "2018-05-28 17:31:32.0",
                "update_at": "2018-05-28 17:31:32.0"
            },
            {
                "id": 215,
                "name": " Default group",
                "type": 2,
                "user_number": 0,
                "company_id": 58,
                "create_at": "2018-05-28 17:31:32.0",
                "update_at": "2018-05-28 17:31:32.0"
            },
            {
                "id": 226,
                "name": "123",
                "type": 1,
                "user_number": 1543,
                "company_id": 58,
                "create_at": "2018-05-30 14:50:17.0",
                "update_at": "2018-05-30 14:50:17.0"
            },
            {
                "id": 231,
                "name": "ccc",
                "type": 1,
                "user_number": 4,
                "company_id": 58,
                "create_at": "2018-06-04 21:52:45.0",
                "update_at": "2018-06-04 21:52:53.0"
            },
            {
                "id": 517,
                "name": "Test",
                "type": 1,
                "user_number": 2,
                "company_id": 58,
                "create_at": "2018-07-02 21:14:41.0",
                "update_at": "2018-07-02 21:14:41.0"
            }
        ]
    }
}

レスポンスのフィールド

dataフィールドの説明

data.dataフィールドの説明

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

2.5.3 グループの登録者リストの取得 (/api/v1/group/user)

概要

グループ ID に基づいてグループ内のすべての登録者のID のリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v1/group/user

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": [
        1014,
        1241,
        2896,
        5124,
        5125,
        5126,
        5127
    ]
}

レスポンスのフィールド

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

2.5.4 登録者グループの更新 (/api/v3/group/update)

概要

登録者グループを更新します。

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

リクエストアドレスの例

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

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "desc": "",
 "data": {
 "id": 253,
 "name": "zml2",
 "type": 1,
 "devices": [{
 "id": 268,
 "name": "q",
 "type": 0
 }],
 "is_default": 0
 }
}

レスポンスのフィールド

dataフィールドの説明

device フィールドの説明

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

2.5.5 グループの削除 (/api/v1/group/delete/{id})

概要

グループを削除します。

リクエストアドレスの例

http://HOST:PORT/api/v1/group/delete/{id}

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

レスポンスのフィールド

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

2.5.6 登録者のグループへの一括追加 (/api/v1/user/add/group)

概要

登録者を一括でグループに追加します。

リクエストアドレスの例

http://HOST:PORT/api/v1/user/add/group

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

レスポンスフィールドの説明

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

2.5.7 登録者のグループからの一括削除 (/api/v1/user/remove/group)

概要

グループから一括で登録者を削除します。

リクエストアドレスの例

http://HOST:PORT/api/v1/user/remove/group

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

レスポンスのフィールド

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

2.10 部署の API

2.10.1 部署リストの取得 (/api/v2/department)

概要

部署リストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v2/department

リクエスト方法

GET

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data":  "id": 0,
        "name": " 日本コンピュータビジョン",
        "children": [
            {
                "id": 1,
                "name": " 開発部",
                "children": [
                    {
                        "id": 3,
                        "name": " クラウドサービス",
                        "children": [
                            { }
                        ],
                        "parent_id": 1,
                        "leader_id": 370108,
                        "leader_name": "test1",
                        "user_num": 15
                    },
                    {
                        "id": 56,
                        "name": "test2",
                        "children": [],
                        "parent_id": 1,
                        "leader_id": null,
                        "leader_name": null,
                        "user_num": 0
                    }
                ],
                "parent_id": 0,
                "leader_id": 372345,
                "leader_name": "leader",
                "user_num": 17
            }
      ]
}

レスポンスのフィールド

department フィールドの説明

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

2.10.2 部署コードでの部署の検索 (/api/v2/department/search/code)

概要

部署コードから部署情報を取得します。

リクエストアドレスの例

https://HOST:PORT/api/v2/department/search/code

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 11,
        "name": "test",
        "code": "003",
        "parent_id": 0,
        "leader_id": null
    }
}

レスポンスのフィールド

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

2.10.3 ID での部署の検索 (/api/v2/department/{id})

概要

部署 ID から部署情報を取得します。

リクエストアドレスの例

https://HOST:PORT/api/v2/department/{id}

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 2,
        "name": " 開発部",
        "code": “003”,
        "parent_id": 0,
        "leader_id": 55505
    }
}

レスポンスのフィールド

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

2.10.4 部署の作成 (/api/v2/department)

概要

部署作成のインターフェースです。

リクエストアドレスの例

https://HOST:PORT/api/v2/department

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 2,
        "name": " 開発部",
        "code": null,
        "parent_id": 0,
        "leader_id": 55505
    }
}

レスポンスのフィールド

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

2.10.5 部署の更新 (/api/v2/department/update)

概要

部署インターフェースを更新します。

リクエストアドレスの例

https://HOST:PORT/api/v2/department/update

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 2,
        "name": "開発部",
        "code": null,
        "parent_id": 0,
        "leader_id": 55505
    }
}

レスポンスのフィールド

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

2.10.6 部署の削除 (/api/v2/department/delete)

概要

部署を削除します。

リクエストアドレスの例

https://HOST:PORT/api/v2/department/delete

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

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

2.7 アクセスルールAPI

2.7.1 タイムテーブルの追加 (/api/v3/pass/timetable)

概要

タイムテーブルを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/timetable

リクエスト方法

POST application/json

リクエストパラメーター

Time フィールドの説明

Special_day フィールドの説明

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

time フィールドの説明

special_day フィールドの説明

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

2.7.2 タイムテーブルの削除 (/api/v3/pass/timetable/delete)

概要

タイムテーブルを削除します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/timetable/delete

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

2.7.3 タイムテーブルの更新 (/api/v3/pass/timetable/update)

概要

タイムテーブルを更新します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/timetable/update

リクエスト方法

POST application/json

リクエストパラメーター

time フィールドの説明

special_day フィールドの説明

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

time フィールドの説明

special_day フィールドの説明

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

2.7.4 タイムテーブルリストの取得 (/api/v3/pass/timetable/list)

概要

タイムテーブルリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/timetable/list

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

2.7.5 タイムテーブルの詳細の取得 (/api/v3/pass/timetable)

概要

タイムテーブルの詳細を取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/timetable

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

time フィールドの説明

special_day フィールドの説明

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

2.7.6 アクセスルールの追加 (/api/v3/pass/rule)

概要

アクセスルールを追加します。一括追加をサポートします。最初にデバイスをグループに連携する必要があります。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/rule

リクエスト方法

POST application/json

リクエストパラメーター

passRule フィールドの説明

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

2.7.7 アクセスルールの削除 (/api/v3/pass/rule/delete)

概要

アクセスルールを削除します。一括削除が可能です。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/rule/delete

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

2.7.8 アクセスルールリストの取得 (/api/v3/pass/rule/list)

概要

構成されているアクセスルールのリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/rule/list

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

2.7.9 デバイスおよびグループの連携情報の取得（アクセスルール情報を含む） (/api/v3/pass/devices/passrules)

概要

すべてのデバイスおよびグループの連携関係（アクセスルール情報を含む）を取得します。

リクエストアドレスの例

https://HOST:PORT/api/v3/pass/devices/passrules

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

timetableGroup フィールドの説明

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

2.2 デバイスの API

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

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

概要

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

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

リクエストアドレスの例

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

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

group フィールドの説明

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

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

概要

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

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

リクエストアドレスの例

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

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

cameraフィールドの説明

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

リクエストパラメーター

デバイス型番識別子

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

認証パラメーター

リクエスト例

通常のレスポンス

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

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

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

概要

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

リクエストアドレスの例

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

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

リクエスト例

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

概要

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

リクエストアドレスの例

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

リクエスト方法

GET

リクエストパラメーター

デバイス型番識別子

認証パラメーター

通常のレスポンス

レスポンスのフィールド

2.11 イベントサブスクリプション API

2.11.1 概要

外部システムはSenseLinkのサブスクリプションサービスを利用することで、SenseLinkのイベントをサブスクライブすることができます。SenseLinkはデバイスの認証とアラート（以下、「イベント」）をPOSTリクエスト（以下、「Push」）することができます。

2.11.2 利用の開始

イベントをサブスクライブする外部システムのAPIエンドポイントは、SenseLinkのWeb UIのナビゲーションメニュー [システム管理]→[Open Platform] 内のサブスクリプションサービスステータス欄、もしくは本マニュアル内のAPIで設定および更新することができます。

サブスクリプションサービス設定画面が表示されます。

イベント処理サーバーアドレスの欄に、連携する外部システムのサーバーアドレスを入力してください。http、httpsをサポートしています。https://またはhttps://から入力してください。

サブスクリプションイベントタイプ欄では、サブスクライブするイベントのタイプを選んでください。デバイスで認証が行われた際に認証レコードをPushで受け取るには認証レコードを、デバイスアラートが発生した場合にPushで受け取るにはデバイスアラートを選択してください。両方を選択することも可能です。

サブスクリプションを更新した際に、再保存時に認証レコードタイプ/デバイスアラートタイプが「未選定」の状態になる場合があります。その場合は、再設定してください。

設定が完了したら、保存ボタンをクリックしてください。Open Platform画面に戻ります。サブスクリプションサービスステータスがNormalと表示されていれば、イベントがサブスクライブされています。

2.11.3 サブスクリプションサービスの設定の変更と停止

サブスクリプションサービスの設定を変更するにはサブスクリプションサービス欄の詳細ボタンをクリックしてください。

サブスクリプションサービスを停止するにはサブスクリプション停止ボタンをクリックしてください。サービスが停止され、外部システムにイベントがPushされなくなります。

サブスクリプションサービスの設定を修正するには、サブスクリプション更新ボタンをクリックしてください。設定内容を変更できます。変更内容を入力後、保存してください。

2.11.4 イベントの再Push

イベントのPush後、外部システムは100秒以内にレスポンスを返却するか、リターンコード200を返却する必要があります。

レスポンスが100秒以内に返却されない場合、またはリターンコードが200以外の場合はエラーとみなされ、SenseLinkはそのイベントを再Pushしません。その後SenseLinkは外部システムのサブスクリプションステータスを「異常」に変更し、エラーログとして保存されます。ただし、その後発生した新しいイベントのPushには影響はありません。

なお、レスポンスが100秒以内に返却された、かつリターンコードが200になった場合、サブスクリプションステータスは「正常」に戻ります。

2.11.5 イベントPushログ

Open Platform画面のサブスクリプションサービスステータス欄の詳細をクリックし、サブスクリプションサービスの設定画面にあるログボタンをクリックすると、最新のイベントPushの結果（以下、「ログ」）を確認することができます。

ログは最大100件まで保存され、100を越えると古いものから順に削除されます。各ログの詳細ボタンをクリックすると認証レコードページまたはデバイスアラートページに遷移し、イベントの詳細を確認することができます。イベントタイプまたはステータスで、ログを検索することができます。リセットボタンをクリックすると検索による絞り込みがリセットされ、すべてのログが表示されます。

テストイベント送信ボタンをクリックすると、テストイベントを連携中の外部システムにPush することができます。認証レコードとデバイスアラートが選択されている場合、または認証レコードのみが選択されている場合は認証レコードのテストイベントが送信されます。デバイスアラートのみが選択されている場合、デバイスアラートのテストイベントが送信されます。

2.11.6 イベントPushのプロトコル

リクエスト方法

POST application/json

イベントPushの例

認証レコード :

デバイスアラート :

Pushするイベントのパラメーター

認証レコードデータの属性 :

group フィールドの説明

デバイスのアラートレコードのデータ属性 :

通常のレスポンス

レスポンスのフィールド

2.11.7 サブスクリプション更新API (/api/v3/event/updateSub)

概要

イベントのサブスクリプションを追加または更新します。

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

リクエストアドレスの例

https://HOST:PORT/api/v3/event/updateSub

リクエスト方法

POST application/json

リクエストパラメーター

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

2.11.8 サブスクリプション停止API (/api/v3/event/stopSub)

概要

イベントのサブスクリプションを停止します。

リクエストアドレスの例

https://HOST:PORT/api/v3/event/stopSub

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

2.11.9 サブスクリプション詳細表示API (/api/v3/event/viewSub)

概要

サブスクリプションの詳細を表示します。

リクエストアドレスの例

https://HOST:PORT/api/v3/event/viewSub

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

2.11.10 イベントPushログの表示 (/api/v3/event/viewLog)

概要

イベントのPushログを表示します。

サブスクリプションサービスが起動されなくても、該当するAPIを使って前に生成されたログを取得できます。

リクエストアドレスの例

https://HOST:PORT/api/v3/event/viewLog

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

dataフィールドの説明

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

2.11.11 テストイベントの送信 (/api/v3/event/sendTest)

概要

テストイベントをPush送信します。

リクエストアドレスの例

https://HOST:PORT/api/v3/event/sendTest

リクエスト方法

GET

認証パラメーター

通常のレスポンス

レスポンスのフィールド

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

2.4 登録者の API

APIでの登録者操作では顔写真品質チェッのレベル低実施されます。ご注意ください。

2.4.1 従業員の追加 (/api/v1/user)

概要

従業員を追加します。

リクエストアドレスの例

https://HOST:PORT/api/v1/user

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 65838,
        "name": "1312313123123122",
        "avatar": "5cbe78b135060d0001750ef5",
        "mobile": "",
        "remark": "",
        "type": 1,
        "birthday": "",
        "mail": null,
        "position": null,
        "location": null,
        "groupList": [
            {
                "id": 1,
                "name": "Default group",
                "type": 1
            }
        ],
        "gender": 1,
        "prompt": "",
        "ic_number": "",
        "id_number": "te9+d6aXoDe5zTCUywgn9+zmx4HElB4W",
        "job_number": "",
        "company_id": 1,
        "create_at": "2019-04-23 10:30:08",
        "update_at": "2019-04-23 10:30:08",
        "department_id": 0,
        "area_code": null,
        "entry_time": "2018-9-10"
    }
}

類似登録者が存在する場合のレスポンス

{
    "code": 30002,
    "message": "Similar User Exist",
    "data": {
        "similar_user_id": 65833,
        "similar_user_name": "11111111",
        "similar_user_avatar": "5cbe7dec35060d0001750f15",
        "can_force": 0
    },
    "desc": "ex.similar-user"
}

レスポンスのフィールド

group フィールドの説明

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

2.4.2 従業員情報の変更 (/api/v2/user/update/{id})

概要

従業員情報を変更します。

バージョン v1 から、従業員ID、IC カード番号、および空の ID 番号の処理ロジックが改善されました。パラメーターが渡されなかった場合やパラメーターが null の場合、変更は行われません。空の string (””）が渡された場合、空として設定されます。バージョン v1 のインターフェースは、引き続きご利用いただくことができます。

リクエストアドレスの例

https://HOST:PORT/api/v2/user/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

group フィールドの説明

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 79653,
 "name": "1312313123123122",
 "avatar": "",
 "mobile": "123",
 "remark": "",
 "type": 1,
 "birthday": null,
 "mail": null,
 "position": null,
 "location": null,
 "groupList": [{
 "id": 1,
 "name": "Default group",
 "type": 1
 }],
 "gender": null,
 "prompt": null,
 "ic_number": "1234000",
 "id_number": null,
 "job_number": "120003",
 "company_id": 1,
 "create_at": null,
 "update_at": "2019-08-22 11:03:18",
 "department_id": null,
 "area_code": null,
 "entry_time": null,
 }
}

レスポンスのフィールド

group フィールドの説明

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

2.4.3 従業員の削除 (/api/v1/user/delete/{id})

概要

従業員を削除します。

リクエストアドレスの例

https://HOST:PORT/api/v1/user/delete/{id}

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

レスポンスのフィールド

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

2.4.4 指定された日付（日）に追加、または更新された従業員アバターの取得（/api/v2/staff/image_updated）

概要

指定された日付（日）に追加、または更新された従業員アバターリストを取得します。

リクエストアドレスの例

https://HOST:PORT/api/v2/staff/image_updated

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
  "code": 200,
  "message": "OK",
	"data": [
        {
             "employee_id":"001"
             "image_URL": "xxx",
             "remark": 0
         },
         {
             "employee_id":"002"
             "image_URL": "xxx",
             "remark": 1
         }
    ]
}

レスポンスのフィールド

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

2.4.5 ビジターの追加 (/api/v1/guest)

概要

ビジターを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v1/guest

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 79661,
 "name": "zml",
 "avatar": "5d5e36e4f684640001b34027",
 "mobile": "123",
 "remark": "",
 "groups": [],
 "position": null,
 "level": null,
 "mail": null,
 "birthday": null,
 "prompt": null,
 "gender": null,
 "ic_number": "",
 "id_number": "kBDHQ/IUQtY=",
 "company_id": 1,
 "reception_user_id": 4567,
 "reception_user_name": "太朗",
 "group_count": 0,
 "date_time": "2018-07-20 12:30:45.0",
 "date_time_from": "2018-07-20 12:30:45.0",
 "date_time_to": "2020-07-20 12:30:45.0",
 "create_at": "2019-08-22 14:32:04.0",
 "update_at": "2019-08-22 6:32:04.0",
 "area_code": null,
 "guest_company": null,
 "guest_purpose": null
 }
}

レスポンスのフィールド

group フィールドの説明

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

2.4.6 ビジター情報の変更 (/api/v1/guest/update/{id})

概要

ビジター情報を変更します。

（すでに登録済みの他者の写真を利用して更新する場合、ビジター情報の変更や顔認証が正常に登録や正常に行われません。ご注意ください。）

リクエストアドレスの例

https://HOST:PORT/api/v1/guest/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 124379,
 "name": "zml",
 "avatar": "5dad624c199e160001c45e8f",
 "mobile": "123",
 "remark": "",
 "groups": [{
 "id": 14,
 "name": "Default group",
 "type": 2
 }],
 "position": "",
 "level": "",
 "mail": "",
 "birthday": null,
 "prompt": "",
 "gender": 2,
 "ic_number": "",
 "id_number": "kBDHQ/IUQtY=",
 "company_id": 12,
 "reception_user_id": 124794,
 "reception_user_name": "太朗",
 "group_count": 1,
 "date_time": "2018-07-20 12:30:45",
 "date_time_from": "2018-07-20 12:30:45",
 "date_time_to": "2020-07-20 12:30:45",
 "create_at": "2019-10-21 15:51:28",
 "update_at": "2019-10-30 20:45:05",
 "area_code": "86",
 "guest_company": "",
 "guest_purpose": ""
 }
}

レスポンスのフィールド

group フィールドの説明

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

2.4.7 ビジターの削除 (/api/v1/guest/delete/{id})

概要

ビジターを削除します。

リクエストアドレスの例

https://HOST:PORT/api/v1/guest/delete/{id}

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

レスポンスのフィールド

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

2.4.8 ブラックリストの追加 (/api/v2/black)

概要

ブラックリストを追加します。

リクエストアドレスの例

https://HOST:PORT/api/v2/black

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 66865,
        "name": "山田",
        "avatar": "5d084f23b2814100015ad03c",
        "mobile": "13655588555",
        "mail": "1365558@mail.com",
        "birthday": "2019-06-11",
        "remark": "demo",
        "groups": [
            {
                "id": 126,
                "name": "デフォルトブラックリスト",
                "type": 3
            },
            {
                "id": 127,
                "name": "2",
                "type": 3
            }
        ],
        "prompt": "ようこそ",
        "gender": 0,
        "createBy": "OPEN API",
        "avatar_show": "",
        "ic_number": "",
        "id_number": "1545557788555",
        "area_code": "86",
        "last_type": 0,
        "create_at": "2019-06-18 02:40:35.0"
    }
}

レスポンスのフィールド

group フィールドの説明

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

2.4.9 ブラックリストへの移動 (/api/v2/black/move/in)

概要

既存の従業員またはビジターを選択してブラックリストに移動（登録者タイプを変更）します。

ブラックリストに移動した後、登録者タイプがブラックリスト（type = 5）に変更されます。元の登録者グループと部署情報はクリアされますが、他の情報は保持されます。

リクエストアドレスの例

https://HOST:PORT/api/v2/black/move/in

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

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

2.4.10 ブラックリストからの削除 (/api/v2/black/move/out)

概要

ブラックリストを削除します。ブラックリストから外されると、登録者タイプは元の識別子に戻ります（タイプ 1 または 2）。他の情報は保持されます。ブラックリストの登録者自体を削除するには、「ブラックリストの削除」の章を参照してください。

リクエストアドレスの例

https://HOST:PORT/api/v2/black/move/out

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

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

2.4.11 ブラックリストの変更 (/api/v2/black/update)

概要

ブラックリストの情報を変更します。

リクエストアドレスの例

https://HOST:PORT/api/v2/black/update

リクエスト方法

POST: form-data

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "desc": "",
 "data": {
 "id": 124759,
 "name": "668089",
 "avatar": "5dba86ff7bf01300010b02c9",
 "mobile": "",
 "mail": "",
 "birthday": "",
 "remark": "",
 "groups": [{
 "id": 15,
 "name": "Blacklist default group",
 "type": 5
 }],
 "prompt": "",
 "gender": 2,
 "avatar_show": "",
 "ic_number": "",
 "id_number": "3O8bqu0sRiKA7+LVRzE3eQ==",
 "area_code": "86",
 "last_type": 0,
 "create_by": "admin1234",
 "create_at": "2019-10-23 17:28:19"
 }
}

レスポンスのフィールド

group フィールド

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

2.4.12 ブラックリストの削除 (/api/v2/black/delete/{id})

概要

ブラックリストを削除します。

リクエストアドレスの例

https://HOST:PORT/api/v2/black/delete/{id}

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

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

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

2.4.13 登録者の参照 (/api/v1/user/list)

概要

従業員、ビジター、およびブラックリストのすべての登録者の情報を取得します。特定のフィールドのフィルター検索が可能です。

リクエストアドレスの例

https://HOST:PORT/api/v1/user/list

リクエスト方法

GET

リクエストパラメーター

認証パラメーター

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "id": 67015,
            "name": "太郎",
            "avatar": "5d0afdde1870ac00019ffffd",
            "mobile": "1882960772",
            "remark": "",
            "type": 1,
            "birthday": null,
            "mail": "",
            "position": "",
            "location": "",
            "groupList": [
                {
                    "id": 1,
                    "name": "Default group",
                    "type": 1
                }
            ],
            "gender": 1,
            "prompt": "",
            "ic_number": "",
            "id_number": "",
            "job_number": "",
            "company_id": 1,
            "create_at": "2019-06-20 03:30:37.0",
            "update_at": "2019-06-20 03:30:38.0",
            "department_id": 0,
            "area_code": "86",
            "entry_time": null,
            "country_code": null,
            "place_code": null,
            "staff_type": 0,
            "reception_user_id": 0,
            "date_time_from": "2017-01-01 00:00:00.0",
            "date_time_to": "2017-01-01 00:00:00.0",
            "avatar_show": null,
            "phone_suffix": "",
            "guest_company": null,
            "guest_purpose": null,
            "guest_level": null,
            "add_time": "2019-06-20 03:30:38.0",
            "guest_auth_status": 1,
            "last_type": 0
        }
    ]
}

レスポンスのフィールド

group フィールドの説明

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

2.8 レコードの API

2.8.1 認証レコードの表示 (/api/v3/record/list)

2.8 レコードの API

2.8.1 認証レコードの表示 (/api/v3/record/list)

改訂履歴

2 APIリファレンス

APIマニュアル

2.1 システムのAPI

2.1.1 バージョン番号の取得 (/api/v3/server/version)

2.1.2 企業情報の取得 (/api/v1/company)

2.3 デバイスアラートの API

2.3.1 デバイスアラートの取得 (/api/v2/device/alarm/list)

2.3.2 デバイスアラートの解除 (/api/v2/device/alarm/disarm)

1 製品概要と利用方法

1.1 製品概要

1.2 キーとシークレットの取得

1.2.1 キーとシークレットの作成と管理

1.2.2 ドメイン管理

1.3 呼び出し方法

1.3.1 シグネチャ（sign）の計算

1.3.2 GET メソッドのインターフェース

1.3.3 POST メソッドのインターフェース

1.4 API エラーコード

2.6 QRコードの API

2.6.1 QRコードコンテンツの生成 (/api/v3/qr/content)

2.9 認証用顔写真の API

2.9.1 顔の数の検知 (/api/v1/recognition/check)

2.9.2 認証用顔写真品質の検出 (/api/v1/recognition/quality)

2.5 登録者グループの API

2.5.1 グループの追加 (/api/v1/group)

2.5.2 登録者グループリストの表示 list (/api/v1/group)

2.5.3 グループの登録者リストの取得 (/api/v1/group/user)

2.5.4 登録者グループの更新 (/api/v3/group/update)

2.5.5 グループの削除 (/api/v1/group/delete/{id})

2.5.6 登録者のグループへの一括追加 (/api/v1/user/add/group)

2.5.7 登録者のグループからの一括削除 (/api/v1/user/remove/group)

2.10 部署の API

2.10.1 部署リストの取得 (/api/v2/department)

2.10.2 部署コードでの部署の検索 (/api/v2/department/search/code)

2.10.3 ID での部署の検索 (/api/v2/department/{id})

2.10.4 部署の作成 (/api/v2/department)

2.10.5 部署の更新 (/api/v2/department/update)

2.10.6 部署の削除 (/api/v2/department/delete)

2.7 アクセスルールAPI

2.7.1 タイムテーブルの追加 (/api/v3/pass/timetable)

2.7.2 タイムテーブルの削除 (/api/v3/pass/timetable/delete)

2.7.3 タイムテーブルの更新 (/api/v3/pass/timetable/update)

2.7.4 タイムテーブルリストの取得 (/api/v3/pass/timetable/list)

2.7.5 タイムテーブルの詳細の取得 (/api/v3/pass/timetable)

2.7.6 アクセスルールの追加 (/api/v3/pass/rule)

2.7.7 アクセスルールの削除 (/api/v3/pass/rule/delete)

2.7.8 アクセスルールリストの取得 (/api/v3/pass/rule/list)

2.7.9 デバイスおよびグループの連携情報の取得 （アクセスルール情報を含む） (/api/v3/pass/devices/passrules)

3 Push通知

3.1.1 認証レコードのPush

3.1.2 アラートレコードのPush

2.2 デバイスの API

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

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

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

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

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

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

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

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

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

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

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

2.11 イベントサブスクリプション API

2.11.1 概要

2.11.2 利用の開始

2.11.3 サブスクリプションサービスの設定の変更と停止

2.11.4 イベントの再Push

2.11.5 イベントPushログ

2.11.6 イベントPushのプロトコル

リクエスト方法

イベントPushの例

Pushするイベントのパラメーター

通常のレスポンス

2.11.7 サブスクリプション更新API (/api/v3/event/updateSub)

2.7.9 デバイスおよびグループの連携情報の取得（アクセスルール情報を含む） (/api/v3/pass/devices/passrules)