Skip to content

根据IMEI获取设备详细信息

接口说明

获取单个或多个设备的详细信息

请求URL

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

HTTP请求方式

GET/POST

请求参数

(1)通用参数
参见: 通用参数
(2)私有参数

参数名参数类型是否必须默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
imeisString设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI)

返回值

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

result参数列表:

参数类型描述
imeiString设备IMEI
deviceNameString设备名称
accountString所属用户账号
activationTimeString激活时间
expirationString过期时间
mcTypeString机型
simString卡号
bindUserAccountString绑定用户账号
statusString状态
driverPhoneString司机电话
driverNameString司机名称
vehicleIconString车辆图标
equipTypeString设备类型(WIRED:有线 WIRELESS:无线)
mcTypeUseScopeString机型使用范围(aotomobile:汽车 electromobile:电动车 personal:个人 pet:宠物 plane:飞机 others:其他)
reMarkString备注
snString箱号
vehicleNameString车辆名称
vehicleNumberString车牌号
vehicleColorString车辆颜色
vehicleModelsString车辆品牌
carFrameString车架号
idCardString身份证
engineNumberString发动机号
installTimeString安装时间
installAddressString安装地址
installCompanyString安装公司
installPositionString安装位置
installPersonnelString安装人员
installImageString安装图片
salesManString业务员
macString设备蓝牙 mac 地址
iccidStringiccid
channelInteger视频通道
videoFlagString是否支持视频(0:否 1:是)

正确返回示例:

js
{
    "code": 0,
    "message": "success",
    "result": [
        {
            "imei": "202604221147000",
            "deviceName": "V541S-47000",
            "account": "123456789",
            "activationTime": "2026-04-22 12:48:42",
            "expiration": "2041-04-22 12:48:42",
            "mcType": "V541S",
            "sim": "1440760599937",
            "bindUserAccount": null,
            "status": "NORMAL",
            "driverPhone": "",
            "vehicleIcon": "automobile",
            "equipType": "WIRED",
            "mcTypeUseScope": "aotomobile",
            "reMark": "",
            "sn": "",
            "vehicleName": "测试车辆名称",
            "vehicleNumber": "",
            "vehicleColor": "",
            "vehicleModels": "",
            "carFrame": "CJH00100016666",
            "driverName": "测试司机名称",
            "idCard": "",
            "engineNumber": "",
            "installTime": "2026-04-22",
            "installAddress": "4S店",
            "installCompany": "测试公司",
            "installPosition": "中控台",
            "installPersonnel": "理想",
            "installImage": "",
            "salesMan": "",
            "mac": "c4a82810115a",
            "iccid": "89860476162090029937",
            "channel": 1,
            "videoFlag": "0"
        }
    ],
    "data": null
}

错误返回示例:

js
{"code":xxx,"message":"非法设备"}