2.8 レコードの API

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

概要

認証レコードを表示します。

SenseLink Cloudを利用する場合のみ使用できます。

SenseLink GE EnterpriseとSenseLink GE Enterprise Proを利用する場合は、V3を使用してください。

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

リクエストアドレスの例

https://HOST:PORT/api/v5/record/list

リクエスト方法

GET

リクエストパラメーター

パラメーター名

型

必須

説明

date_time_from

string

サーバー時間の作成開始日。デフォルト値は現在の日付の 0 時。例 : 2018-07-20 12:30:45

date_time_to

string

サーバー時間の作成終了日。デフォルト値は現在の日付の 23:59:59。例 : 2019-07-20 12:30:45

order

int

並び順。0 : レコードIDで降順、1 : レコードIDで昇順

page

int

ページ番号（デフォルトは 1 です）

size

int

1 ページあたりのデータの数（デフォルトは 20）。最大値は 100

認証パラメーター

パラメーター名

型

必須

説明

app_key

string

Yes

Appキー

sign

string

Yes

シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください

timestamp

string

Yes

タイムスタンプ

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"list": [{
			"id": 1392523,
			"direction": 0,
			"latitude": null,
			"longitude": null,
			"address": null,
			"location": "6488+",
			"remark": null,
			"groups": [],
			"mobile": null,
			"mask": 0,
			"capture_picture": "5fceef6e1ddb2800010d1409",
			"capture_bg_picture": "5fceef6e1ddb2800010d140a",
			"avatar": "",
			"heat_avatar": null,
			"user_id": 0,
			"user_name": "",
			"user_type": 3,
			"group_id": null,
			"group_name": null,
			"device_name": "6488+",
			"device_ldid": "SPSE-6b394fa48b464d54e41f3f1895178fb0",
			"sign_time": 1607397229,
			"country_code": null,
			"place_code": null,
			"on_business": 0,
			"entry_mode": 1,
			"sign_time_zone": "GMT+09:00",
			"user_group": null,
			"verify_score": 0.359,
			"mis_id": null,
			"mis_type": null,
			"doc_photo": "",
			"ic_number": "",
			"id_number": "",
			"abnormal_type": 0,
			"job_number": null,
			"user_ic_number": null,
			"user_id_number": "",
			"reception_user_id": null,
			"reception_user_name": "",
			"sign_date": "2020-12-08",
			"user_remark": null,
			"body_temperature": 0.0
		}],
		"page_num": 2,
		"page_size": 10
	}
}

レスポンスのフィールド

パラメーター名

型

説明

code

int

リターンコード

message

string

リターンメッセージ

data

object

データ

dataフィールドの説明

パラメーター名

型

説明

list

list<recordItem>

認証レコード詳細

page_num

int

ページ番号（デフォルトは 1 です）

page_size

int

1 ページあたりのデータの数（デフォルトは 20）。最大値は 100

recordItem フィールドの説明

パラメーター名

型

説明

int

認証レコード ID

direction

int

デバイスのアクセス方向

latitude

double

緯度

longitude

double

経度

address

string

住所

location

string

勤務地

mobile

string

携帯電話番号

remark

string

特記事項

groups

list<group>

グループ

capture_picture

string

認証時にデバイスが撮影した写真（サムネイル）の ID

capture_bg_picture

string

認証時にデバイスが撮影した写真（大）の ID

avatar

string

認証用顔写真

heat_avatar

string

認証時にデバイスが撮影したサーマル画像

user_id

int

登録者 ID

user_name

string

登録者名

user_type

int

登録者タイプ

group_id

int

グループ ID

group_name

string

グループ名

device_name

string

デバイス名

device_ldid

string

デバイス LDID

sign_time

string

認証時間

entry_mode

int

認証モード

sign_time_zone

string

タイムゾーン

verify_score

float

認証スコア

mis_id

int

誤認証 ID

mis_type

int

誤認証タイプ

doc_photo

string

ID カード写真（利用できません）

ic_number

string

IC カード番号

id_number

string

ID カード番号読み込み（利用できません）

abnormal_type

int

異常レコードタイプ　0：なし、10001：IDカード不一致、10002：認証カード不一致、10003：認証コード不一致、20001：ビジターが有効期限外、20002：アクセス時間外、30001：無効な ID カード、30002：無効な IC カード、30003：無効な QR コード、40001：体温が異常、50001：マスク着用無し

job_number

string

従業員ID

user_ic_number

string

登録者 IC カード番号

user_id_number

string

登録者 ID 番号

reception_user_id

long

受付担当者 ID

reception_user_name

string

受付担当者名

user_remark

string

登録者コメント

sign_date

string

認証日

body_temperature

float

体温

mask

int

マスク着用識別子。0：不明、1：着用なし、2：着用あり

group フィールドの説明

パラメーター名

型

説明

long

グループID

name

string

グループ名

type

int

グループタイプ

2.8.2 認証レコードの表示 (/api/v4/record/list)

概要

認証レコードを表示します。

SenseLink Cloudを利用する場合のみ使用できます。

SenseLink GE EnterpriseとSenseLink GE Enterprise Proを利用する場合は、V3を使用してください。

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

リクエストアドレスの例

https://HOST:PORT/api/v4/record/list

リクエスト方法

GET

リクエストパラメーター

パラメーター名

型

必須

説明

date_time_from

string

サーバー時間の作成開始日。デフォルト値は現在の日付の 0 時。例 : 2018-07-20 12:30:45

date_time_to

string

サーバー時間の作成終了日。デフォルト値は現在の日付の 23:59:59。例 : 2019-07-20 12:30:45

order

int

並び順。0 : レコードIDで降順、1 : レコードIDで昇順

page

int

ページ番号（デフォルトは 1 です）

size

int

1 ページあたりのデータの数（デフォルトは 20）。最大値は 100

認証パラメーター

パラメーター名

型

必須

説明

app_key

string

Yes

Appキー

sign

string

Yes

シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください

timestamp

string

Yes

タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "list" : [
            {
            "id": 1361801,
            "direction": 0,
            "latitude": null,
            "longitude": null,
            "address": null,
            "location": "306lsh",
            "remark": null,
            "mobile": "",
            "groups": [
                {
                    "id": 1,
                    "name": "default group",
                    "type": 1,
                    "devices": null,
                    "is_default": null
                }
            ],
            "capture_picture": "5d886e584bb1c40001ad458e",
            "capture_bg_picture": "5d886e584bb1c40001ad458f",
            "avatar": "5d7a680a4bb1c40001ac80f6",
            "heat_avatar":null,
            "user_id": 100100,
            "user_name": "xlp update",
            "user_type": 1,
            "group_id": null,
            "group_name": null,
            "device_name": "lsh02",
            "device_ldid": "SPS-257bfefb52b1b88237d195c1ad944063",
            "sign_time": 1569222232,
            "country_code": null,
            "place_code": null,
            "on_business": 0,
            "entry_mode": 1,
            "sign_time_zone": "GMT+08:00",
            "verify_score": null,
            "mis_id": null,
            "mis_type": null,
            "doc_photo": "",
            "ic_number": "",
            "id_number": "",
            "abnormal_type": null，
            "job_number": "",
            "user_ic_number": "",
            "user_id_number": "",
            "reception_user_id": 0,
            "reception_user_name": "",
            "sign_date": "2019-11-26",
            "user_remark": "",
            "body_temperature": 37.3,
            "mask":1
            }
        ],
        "total" : 19
    }
}

レスポンスのフィールド

パラメーター名

型

説明

code

int

リターンコード

message

string

リターンメッセージ

data

object

データ

dataフィールドの説明

パラメーター名

型

説明

list

list<recordItem>

認証レコード詳細

total

int

認証レコード合計数

recordItem フィールドの説明

パラメーター名

型

説明

int

認証レコード ID

direction

int

デバイスのアクセス方向

latitude

double

緯度

longitude

double

経度

address

string

住所

location

string

勤務地

mobile

string

携帯電話番号

remark

string

特記事項

groups

list<group>

グループ

capture_picture

string

認証時にデバイスが撮影した写真（サムネイル）の ID

capture_bg_picture

string

認証時にデバイスが撮影した写真（大）の ID

avatar

string

認証用顔写真

heat_avatar

string

認証時にデバイスが撮影したサーマル画像

user_id

int

登録者 ID

user_name

string

登録者名

user_type

int

登録者タイプ

group_id

int

グループ ID

group_name

string

グループ名

device_name

string

デバイス名

device_ldid

string

デバイス LDID

sign_time

string

認証時間

entry_mode

int

認証モード

sign_time_zone

string

タイムゾーン

verify_score

float

認証スコア

mis_id

int

誤認証 ID

mis_type

int

誤認証タイプ

doc_photo

string

ID カード写真（利用できません）

ic_number

string

IC カード番号

id_number

string

ID カード番号読み込み（利用できません）

abnormal_type

int

job_number

string

従業員ID

user_ic_number

string

登録者 IC カード番号

user_id_number

string

登録者 ID 番号

reception_user_id

long

受付担当者 ID

reception_user_name

string

受付担当者名

user_remark

string

登録者コメント

sign_date

string

認証日

body_temperature

float

体温

mask

int

マスク着用識別子。0：不明、1：着用なし、2：着用あり

group フィールドの説明

パラメーター名

型

説明

long

グループID

name

string

グループ名

type

int

グループタイプ

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

概要

認証レコードを表示します。

リクエストアドレスの例

https://HOST:PORT/api/v3/record/list

リクエスト方法

GET

リクエストパラメーター

パラメーター名

型

必須

説明

start_record_id

long

認証レコードの開始ID

end_record_id

long

認証レコードの終了ID

device_sn

string

デバイスシリアル番号

type

int

タイプ：{ 1：従業員、2：ビジター、3：未登録人物、 5 : 拒否リスト}

user_id

long

登録者ID

date_time_from

string

ローカル時間の開始日。デフォルト値は現在の日付の 0 時。例 : 2018-07-20 12:30:45

date_time_to

string

ローカル時間の終了日。デフォルト値は現在の日付の 23:59:59。例 : 2019-07-20 12:30:45

name

string

登録者名

page

int

ページ番号（デフォルトは 1 です）

size

int

1 ページあたりのデータの数（デフォルトは 20）。最大値は 100

entry_mode

int

認証モード（1：顔認証、2：QR コード、3：カード、4：顔認証とカード、5 : ID カード、6：顔認証と ID カード） 1：顔認証のみ利用できます

user_id

long

登録者ID

group_id

long

グループID

mis_type

int

誤認証タイプ。1：別の人物、2：未登録人物、3：非生体、4：未登録人物からの攻撃、5：非生体からの攻撃

abnormal_types

int

認証レコードの以上検知タイプ。0：なし、10001：IDカード不一致、10002：認証カード不一致、10003：認証コード不一致、20001：ビジターが有効期限外、20002：アクセス時間外、30001：無効な ID カード、30002：無効な IC カード、30003：無効な QR コード、40001：体温が異常、50001：マスク着用無し

認証パラメーター

パラメーター名

型

必須

説明

app_key

string

Yes

Appキー

sign

string

Yes

シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください

timestamp

string

Yes

タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "total": 118,
        "size": 3,
        "data": {
            "total": 118,
            "user_count": 35,
            "guest_count": 0,
            "stranger_count": 65,
            "record_list": [
                    {
                    "id": 1361801,
                    "direction": 0,
                    "latitude": null,
                    "longitude": null,
                    "address": null,
                    "location": "306lsh",
                    "remark": null,
                    "mobile": "",
                    "groups": [
                        {
                            "id": 1,
                            "name": "Default group",
                            "type": 1,
                            "devices": null,
                            "is_default": null
                        }
                    ],
                    "capture_picture": "5d886e584bb1c40001ad458e",
                    "capture_bg_picture": "5d886e584bb1c40001ad458f",
                    "avatar": "5d7a680a4bb1c40001ac80f6",
                    "heat_avatar":null,
                    "user_id": 100100,
                    "user_name": "Liping Xiao アップデート",
                    "user_type": 1,
                    "group_id": null,
                    "group_name": null,
                    "device_name": "lsh02",
                    "device_ldid": "SPS-257bfefb52b1b88237d195c1ad944063",
                    "sign_time": 1569222232,
                    "country_code": null,
                    "place_code": null,
                    "on_business": 0,
                    "entry_mode": 1,
                    "sign_time_zone": "GMT+08:00",
                    "verify_score": null,
                    "mis_id": null,
                    "mis_type": null,
                    "doc_photo": "",
                    "ic_number": "",
                    "id_number": "",
                    "abnormal_type": null，
                    "job_number": "",
                    "user_ic_number": "",
                    "user_id_number": "",
                    "reception_user_id": 0,
                    "reception_user_name": "",
                    "sign_date": 2019-11-26",
                    "user_remark": ""，
                    "body_temperature": 37.3，
                    "mask":1
                    }
                }
            ]
        },
        "page_num": 1,
        "page_size": 3,
        "total_page": 40
    }
}

レスポンスのフィールド

パラメーター名

型

説明

code

int

リターンコード

message

string

リターンメッセージ

data

object

データ

dataフィールドの説明

パラメーター名

型

説明

total

int

総計

size

int

容量

data

object

認証レコードの情報

page_num

int

現在のページ番号

page_size

int

ページサイズ

total_page

int

ページ合計

data.dataフィールドの説明

パラメーター名

型

説明

total

int

総計

user_count

int

従業員レコードの数

guest_count

int

ビジターレコードの数

stranger_count

int

未登録者レコードの数

record_list

list<recordItem>

認証レコード

recordItem フィールドの説明

パラメーター名

型

説明

int

認証レコード ID

direction

int

デバイスのアクセス方向

latitude

double

緯度

longitude

double

経度

address

string

住所

location

string

勤務地

mobile

string

携帯電話番号

remark

string

特記事項

groups

list<group>

グループ

capture_picture

string

認証時にデバイスが撮影した写真（サムネイル）の ID

capture_bg_picture

string

認証時にデバイスが撮影した写真（大）の ID

avatar

string

認証用顔写真

heat_avatar

string

認証時にデバイスが撮影したサーマル画像

user_id

int

登録者 ID

user_name

string

登録者名

user_type

int

登録者タイプ

group_id

int

グループ ID

group_name

string

グループ名

device_name

string

デバイス名

device_ldid

string

デバイス LDID

sign_time

string

認証時間

entry_mode

int

認証モード

sign_time_zone

string

タイムゾーン

verify_score

float

認証スコア

mis_id

int

誤認証 ID

mis_type

int

誤認証タイプ

doc_photo

string

ID カード写真（利用できません）

ic_number

string

IC カード番号

id_number

string

ID カード番号読み込み（利用できません）

abnormal_type

int

job_number

string

従業員ID

user_ic_number

string

登録者 IC カード番号

user_id_number

string

登録者 ID 番号

reception_user_id

long

受付担当者 ID

reception_user_name

string

受付担当者名

user_remark

string

登録者コメント

sign_date

string

認証日

body_temperature

float

体温

mask

int

マスク着用識別子。0：不明、1：着用なし、2：着用あり

group フィールドの説明

パラメーター名

型

説明

long

グループID

name

string

グループ名

type

int

グループタイプ

前へ2.7 アクセスルールAPI 次へ2.9 認証用顔写真の API

最終更新 3 年前