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 | 卡号 |
| driverPhone | String | 司机电话 |
| driverName | String | 司机名称 |
| vehicleIcon | String | 车辆图标 |
| equipType | String | 设备类型(WIRED:有线 WIRELESS:无线) |
| mcTypeUseScope | String | 机型使用范围(aotomobile:汽车 electromobile:电动车 personal:个人 pet:宠物 plane:飞机 others:其他) |
| reMark | String | 备注 |
| vehicleName | String | 车辆名称 |
| vehicleNumber | String | 车牌号 |
| installTime | String | 安装时间 |
| vehicleDeviceStatus | 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",
"driverPhone": "25",
"vehicleIcon": "taxi",
"equipType": "WIRED",
"mcTypeUseScope": "electromobile",
"reMark": "123456788012354",
"sn": "123456788012354",
"vehicleName": null,
"vehicleNumber": "123456788012354u",
"carFrame": "123456788012354",
"idCard": "123456788012354",
"engineNumber": "123456788012354",
"installTime": null,
}
]
}错误返回示例:
js
{"code":xxx,"message":"非法设备"}