2.8 レコードの API

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

概要

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

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

リクエストアドレスの例

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 時。

date_time_to

string

終了日。デフォルト値は現在の日付の 23:59:59。

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

シグネチャ。2.2.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",
                    "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，
                }
            ]
        },
        "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

デバイスのアクセス方向

location

string

勤務地

mobile

string

携帯電話番号

remark

string

特記事項

groups

list<group>

グループ

capture_picture

string

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

capture_bg_picture

string

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

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 - 体温が異常

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 年前