Skip to content

根据IMEI获取设备蓝牙打卡报表

接口说明

根据imei号(单次最多100个)、开始时间和结束时间,查询近6个月且时间跨度不超过31天的数据。

请求URL

本接口通用参数里面method的值为jimi.open.device.getBluetoothClock

HTTP请求方式

GET/POST

请求参数

(1)通用参数
参见: 通用参数

(2)私有参数

参数名参数类型是否必须默认值描述
app_keyString分配给应用的AppKey
access_tokenString访问令牌,表明其是一个合法第三方
imeisString设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI)
startTimeString开始时间,格式为yyyy-MM-dd HH:mm:ss
endTimeString结束时间,格式为yyyy-MM-dd HH:mm:ss
statusString打卡类型:1-上班 2-下班
pageNoInteger1页,最小值不能小于1
pageSizeInteger1000每页大小,最大值不能大于1000

返回值

参数类型描述
codeInt返回码:
0: 正确返回
其它: 失败。参考错误码说明
messageString如果code不为0,会有相应的错误信息提示
resultString返回的数据
成功后返回查询结果

result参数列表:

参数类型描述
salesManString业务员
deviceImeiString设备imei
deviceTypeString设备类型
postTimeString打卡时间
statusString打卡类型:1上报 2下班
userNameString所属用户名称
mcTypeString设备机型
rssiString信号强度
macStringmac地址
uuidStringuuid
majarStringmajar参数
minorStringminor参数
userIdString所属用户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":"非法设备"}