查询设备

Request

ENDPOINT

/account/ACCOUNT_KEY/device/DEVICE_KEY

MÉTODO

GET

路径参数

字段	类型	描述	字符数
account_key	uuidv4	账户唯一标识键。	36
device_key	uuidv4	设备唯一标识键。	36

Response

STATUS

200

Response Body: 找到设备

{
  "device_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "session_id": "05894BAD-C94E-4A61-B2A8-57EDAE868A0F",
  "analysis_status": "automatically_approved",
  "status": "registered",
  "device_registration_data": {
    "device_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
    "session_id": "05894BAD-C94E-4A61-B2A8-57EDAE868A0F",
    "document_number": "438.858.048-16",
    "registration_date": "2025-06-30T14:52:13-03:00",
    "face_recognition_key": "367195fc-de24-46b0-9ddb-79231dc7eeff"
  },
  "analysis_status_events": [
    {
      "new_analisys_status": "automatically_approved",
      "reason": null,
      "reason_description": null,
      "event_date": "2025-06-30T14:52:13Z"
    }
  ],
  "status_events": [
    {
      "new_status": "registered",
      "event_date": "2025-06-30T14:52:13Z"
    }
  ],
  "registration_date": "2025-06-30T14:52:14Z",
  "created_at": "2025-06-30T14:52:13Z"
}

Response Body 参数

字段	类型	描述	字符数
device_key *	uuidv4	UUID v4 格式的设备唯一标识键	36
session_id *	uuidv4	通过 device_scan 获取的会话标识符	36
analysis_status *	string	欺诈引擎分析状态	analysis_status 枚举值
status *	string	设备状态	status 枚举值
device_registration_data *	object	设备注册数据	device_registration_data 对象
analysis_status_events *	array	分析状态变更事件历史记录	-
status_events *	array	设备状态变更事件历史记录	-
registration_date *	string	ISO 格式的设备注册日期（UTC - "YYYY-MM-DDTHH:MM:SSZ"）	20
created_at *	string	ISO 格式的设备创建日期（UTC - "YYYY-MM-DDTHH:MM:SSZ"）	20

device_registration_data 对象

字段	类型	描述	字符数
device_key *	uuidv4	UUID v4 格式的设备唯一标识键	36
session_id *	uuidv4	通过 device_scan 获取的会话标识符	36
document_number	string	用户的文件号码（CPF/CNPJ）	14
registration_date *	string	带时区的 ISO 格式注册日期	25
face_recognition_key	uuidv4	人脸识别键（适用时）	36

analysis_status_event 对象

字段	类型	描述	字符数
new_analisys_status *	string	新的分析状态	analysis_status 枚举值
reason	string	状态变更原因（适用时）	-
reason_description	string	状态变更原因描述（适用时）	-
event_date *	string	ISO 格式的事件日期（UTC - "YYYY-MM-DDTHH:MM:SSZ"）	20

status_event 对象

字段	类型	描述	字符数
new_status *	string	设备的新状态	status 枚举值
event_date *	string	ISO 格式的事件日期（UTC - "YYYY-MM-DDTHH:MM:SSZ"）	20

analysis_status 枚举值

枚举值	描述
automatically_approved	欺诈引擎自动批准
automatically_reproved	欺诈引擎自动拒绝
pending	待分析

status 枚举值

枚举值	描述
registered	设备已注册
disabled	设备已停用
pending	设备待审批

STATUS

4xx

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

HTTP 代码 status	QI 代码 code	标题 title	描述（英文） description	描述（葡文） translation
400	QIT000001	Bad Request	Schema Error	Erro de Schema
404	OBD000002	Not Found	Bank account not found	Conta não encontrada
404	OBD000100	Device not found	No device is associated with the provided device_key.	Nenhum dispositivo está associado à device_key fornecida.