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 | 状态 NORMAL-开机 DISABLE-停机 |
| driverPhone | String | 电话 |
| vehicleIcon | String | 车辆图标 |
| equipType | String | 设备类型(WIRED:有线 WIRELESS:无线) |
| mcTypeUseScope | String | 机型使用范围(aotomobile:汽车 electromobile:电动车 personal:个人 pet:宠物 plane:飞机 others:其他) |
| reMark | String | 备注 |
| sn | String | 箱号 |
| vehicleName | String | 车辆名称 |
| vehicleNumber | String | 车牌号 |
| vehicleModels | String | 车辆品牌 |
| carFrame | String | 车架号 |
| driverName | String | 司机名 |
| idCard | String | 身份证 |
| engineNumber | String | 发动机号 |
| installTime | String | 安装时间 |
| installAddress | String | 安装地址 |
| installCompany | String | 安装公司 |
| installPosition | String | 安装位置 |
| installPersonnel | String | 安装人员 |
| installImage | String | 安装图片 |
| salesMan | String | 业务员 |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": [
{
"imei": "987456123012358",
"deviceName": "123456788012354ui",
"account": "jimitest",
"activationTime": "2016-10-27 11:44:29",
"expiration": "2036-10-27 11:44:29",
"mcType": "ET200",
"sim": "22",
"bindUserAccount": null,
"status": "NORMAL",
"driverPhone": "25",
"vehicleIcon": "taxi",
"equipType": null,
"mcTypeUseScope": "electromobile",
"reMark": "123456788012354",
"sn": "123456788012354",
"vehicleName": null,
"vehicleNumber": "123456788012354u",
"vehicleModels": null,
"carFrame": "123456788012354",
"driverName": "是",
"idCard": "123456788012354",
"engineNumber": "123456788012354",
"installTime": null,
"installAddress": "123456788012354",
"installCompany": "123456788012354",
"installPosition": "123456788012354",
"installPersonnel": "123456788012354",
"installImage": "",
"salesMan": null
}
]
}错误返回示例:
js
{"code":xxx,"message":"非法设备"}