Appearance
根据IMEI获取设备蓝牙打卡报表
接口说明
根据imei号(单次最多100个)、开始时间和结束时间,查询近6个月且时间跨度不超过31天的数据。
请求URL
本接口通用参数里面method的值为jimi.open.device.getBluetoothClock
HTTP请求方式
GET/POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| app_key | String | 是 | 分配给应用的AppKey | |
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| imeis | String | 是 | 设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI) | |
| startTime | String | 是 | 开始时间,格式为yyyy-MM-dd HH:mm:ss | |
| endTime | String | 是 | 结束时间,格式为yyyy-MM-dd HH:mm:ss | |
| status | String | 否 | 打卡类型:1-上班 2-下班 | |
| pageNo | Integer | 否 | 1 | 页,最小值不能小于1 |
| pageSize | Integer | 否 | 1000 | 每页大小,最大值不能大于1000 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 返回的数据 成功后返回查询结果 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| salesMan | String | 业务员 |
| deviceImei | String | 设备imei |
| deviceType | String | 设备类型 |
| postTime | String | 打卡时间 |
| status | String | 打卡类型:1上报 2下班 |
| userName | String | 所属用户名称 |
| mcType | String | 设备机型 |
| rssi | String | 信号强度 |
| mac | String | mac地址 |
| uuid | String | uuid |
| majar | String | majar参数 |
| minor | String | minor参数 |
| userId | String | 所属用户ID |
正确返回示例:
plaintext
{
"code": 0,
"message": "success",
"result": null,
"data": [
{
"salesMan": null,
"deviceImei": "202502191111039",
"deviceType": "per",
"postTime": "2026-01-11 14:57:51",
"status": "15",
"userName": null,
"mcType": "GK309",
"rssi": "92",
"mac": "C3-00-00-15-EC-D1",
"uuid": "FDA50693A4E24FB1AFCFC6EB07647825",
"majar": "10001",
"minor": "19641",
"userId": "12875"
}
]
}错误返回示例:
plaintext
{"code":xxx,"message":"非法设备"}