Appearance
根据IMEI获取设备详细信息
接口说明
获取单个或多个设备的详细信息
请求URL
本接口通用参数里面method的值为jimi.open.device.getDetails
HTTP请求方式
GET/POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| imeis | String | 是 | 无 | 设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI) |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 返回的数据 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| imei | String | 设备IMEI |
| deviceName | String | 设备名称 |
| account | String | 所属用户账号 |
| activationTime | String | 激活时间 |
| expiration | String | 过期时间 |
| mcType | String | 机型 |
| sim | String | 卡号 |
| bindUserAccount | String | 绑定用户账号 |
| status | String | 状态 |
| driverPhone | String | 司机电话 |
| driverName | String | 司机名称 |
| vehicleIcon | String | 车辆图标 |
| equipType | String | 设备类型(WIRED:有线 WIRELESS:无线) |
| mcTypeUseScope | String | 机型使用范围(aotomobile:汽车 electromobile:电动车 personal:个人 pet:宠物 plane:飞机 others:其他) |
| reMark | String | 备注 |
| sn | String | 箱号 |
| vehicleName | String | 车辆名称 |
| vehicleNumber | String | 车牌号 |
| vehicleColor | String | 车辆颜色 |
| vehicleModels | String | 车辆品牌 |
| carFrame | String | 车架号 |
| idCard | String | 身份证 |
| engineNumber | String | 发动机号 |
| installTime | String | 安装时间 |
| installAddress | String | 安装地址 |
| installCompany | String | 安装公司 |
| installPosition | String | 安装位置 |
| installPersonnel | String | 安装人员 |
| installImage | String | 安装图片 |
| salesMan | String | 业务员 |
| mac | String | 设备蓝牙 mac 地址 |
| iccid | String | iccid |
| channel | Integer | 视频通道 |
| videoFlag | String | 是否支持视频(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":"非法设备"}