设备

目录

错误码

Http Status Code errorCode desc

 

 

 

 

 

 

 

 

400

420 用户ID为空
421 设备类型错误
422 用户冲突
423 没有注册设备权限
424 设备名已存在
425 注册设备数量已 达到上限
426 设备无效
427 通知类型错误
428 设备类型错误
429 设备型号错误
430 设备归属错误
431 擦除类型错误
432 WIFI地址格式错误
433 WIFI地址已存在
434 指令标识符错误
435 设备状态错误
436 设备越狱状态错误
437 设备扫描类型错误
438 上次在线时间错误
439 失联状态错误
440 获取远程控制结果失败
441 日志文件为空
442 日志上传失败

 

1. 注册设备

描述

注册设备

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
type 设备类型 Integer Y 1 Android, 2 ios
deviceType 设备型号 Integer Y 10 Android Phone ,11 Android Pad ,20 iPhone ,21 iPad  ,22 iPad MINI ,23 iPod Touch
relationship 设备归属 Integer Y 1 企业,2 员工,3 其他
deviceNumber 设备编号 Sting Y
deviceName 设备名称 Sting Y
userId 用户ID Long Y
imei 国际移动设备标识码 String N
imsi 国际移动用户识别码 String N
sdSerialNum SD卡序列号 String N
serialNum 设备序列号 String N
productname 产品类型 String N 例如 iPad4,7

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
deviceId 设备ID Integer 保存成功后生成的设备ID

调用示例

POST /devices?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
    "type": "1",
    "deviceType": "10",
    "relationship": "1",
    "deviceNumber": "456",
    "deviceName": "北京测试",
    "imei": "22222",
    "imsi": "11111111",
    "sdSerialNum": "12434",
    "serialNum": "1234",
    "userId":25
}
输出
HTTP/1.1 200 OK
{
     "deviceId":1
}

2. 编辑设备

描述

编辑已注册设备信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
type 设备类型 Integer N 1 Android, 2 ios
deviceType 设备型号 Integer N 10 Android Phone ,11 Android Pad ,20 iPhone ,21 iPad  ,22 iPad MINI ,23 iPod Touch
relationship 设备归属 Integer N 1 企业,2 员工,3 其他
deviceNumber 设备编号 Sting N
deviceName 设备名称 Sting N
wifiMac WIFI MAC地址 Sting N
userId 用户ID Long N
deviceId 设备ID Long Y
imei 国际移动设备标识码 String N
imsi 国际移动用户识别码 String N
sdSerialNum SD卡序列号 String N
serialNum 设备序列号 String N
productname 产品类型 String N 例如 iPad5,4

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
deviceId 设备ID Integer 保存成功后生成的设备ID

调用示例

POST /devices/{deviceId}?access_token=cb906b1359ab4768a45c18d608a3c2e1

POST /devices/145?access_token=cb906b1359ab4768a45c18d608a3c2e1

输入

Content-Type:application/json;charset=UTF-8
{
    "type":"1",
    "deviceType":"10"
    "relationship":"1",
    "deviceNumber":"456",
    "deviceName":"北京测试",
    "wifiMac":"1-2-2",
    "versionNum":"",
    "userId":25
}
输出
HTTP/1.1 200 OK

3. 设备详情

描述

根据设备ID查询设备详细信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID Long Y

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

 

 

 

 

 

 

baseInfo

设备基本信息

输出参数 参数含义 备注
deviceType 设备类型 10 Android Phone ,11 Android Pad ,20 iPhone ,21 iPad  ,22 iPad MINI ,23 iPod Touch
relationship 设备归属 1 企业,2 员工,3 其他
deviceNumber 资产编号
deviceName 设备名称
serialNum 设备序列号
versioNum 当前操作系统
activateTime 激活时间
lastOnlineTime 上次在线时间
updateTime 上次更新时间
dataencryptionflag 是否加密 0 否, 1是
status 状态  0 已淘汰 1 未激活 2 已激活设备,3已丢失设备,4 已擦除设备,5待擦除设备 6,待淘汰设备

 

 

 

 

 

 

 

 

hardwareInfo

设备硬件信息

输出参数 参数含义 备注
manufacturer 设备厂商
model 型号
imei IMEI
cpu CPU
ram RAM
romCapacity ROM总容量
romAvailableCapacity ROM可用空间
camera 摄像头
bluetoothMac 蓝牙MAC地址
wifiMac WiFi MAC地址
sdCapacity SD卡容量
sdAvailableCapacity SD卡可用空间
sdSerialNum SD卡序列号
powerStatus 电源状态
bootTime 开机时长
imsi IMSI
rootFlag 是否破解/Root 0 -未破解/root 1-已破解/root
remark 资产备注信息
udid 识别码
iccid 集成电路卡识别码
remark 设备备注信息 String

 

 

 

operatorInfo

运营商信息

输出参数 参数含义 备注
operatorName 运营商名称
phoneCode 手机号码
roamingFlag 是否开启漫游 0否 1,开启
flowInfo 流量信息

输出参数 参数含义 备注
currentDaySimCardFlow sim卡当天流量(M)
currentWeekSimCardFlow sim卡本周流量(M)
currentMonthSimCardFlow sim卡本月流量(M)
currentDayWlanFlow wlan卡当天流量(M)
currentWeekWlanFlow wlan卡本周流量(M)
currentMonthWlanFlow wlan卡本月流量(M)
remark 设备备注信息
userInfo 用户信息

输出参数 参数含义 备注
userId 用户ID
userName 用户姓名
loginId 用户名
mail 邮箱
mobile 手机
groupPath 用户组路径 例如 A->B->C
userDelete 是否被删除 1已删除 0 正常

调用示例

GET /devices/{deviceId}?access_token=cb906b1359ab4768a45c18d608a3c2e1
GET /devices/113?access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK
{
"baseInfo": {
"deviceType": 20,
"relationship": 1,
"deviceNumber": null,
"deviceName": "z_iPhone",
"serialNum": "DNRLDJAWFP6H",
"versioNum": null,
"activateTime": "2015-11-30 18:28:57",
"lastOnlineTime": "2015-12-02 19:27:44",
"updateTime": "2015-12-02 18:00:18",
"dataencryptionflag": 0
},
"operatorInfo": {
"operatorName": "",
"phoneCode": null,
"roamingFlag": 1
},
"hardwareInfo": {
"manufacturer": null,
"model": "iphone 5S(16G,ME450CH)",
"imei": "35 802605 295311 7",
"cpu": null,
"ram": null,
"romCapacity": null,
"romAvailableCapacity": null,
"camera": null,
"bluetoothMac": "d8:96:95:48:2f:f9",
"wifiMac": "D8:96:95:48:2F:F8",
"sdCapacity": null,
"sdAvailableCapacity": null,
"sdSerialNum": null,
"powerStatus": "0",
"bootTime": 0,
"imsi": null,
"rootFlag": 0
},
"remark": null,
"flowInfo": {
"currentDaySimCardFlow": 0,
"currentWeekSimCardFlow": 0,
"currentMonthSimCardFlow": 0,
"currentDayWlanFlow": 0,
"currentWeekWlanFlow": 30.03,
"currentMonthWlanFlow": 30.03
}
}

4.  查找设备

描述

根据参数获取设备列表

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
status 设备状态 Integer N  0 已淘汰 1 未激活 2 已激活设备,3已丢失设备,4 已擦除设备,5待擦除设备 6,待淘汰设备
serialNum 设备序列号 String N
imei IMEI String N
relationship 设备归属 Integer N 1 企业,2 员工,3 其他
type 类型 Integer N 1Android 2ios
rootFlag 是否 root或者越狱 Integer N 1 是 ,0 否
scanStatus 安全状态 Integer N 0有病毒设备,1安全设备,2未扫描
lastOnline 上次在线时间 Integer N 时间差值 输入必须为负数 单位为分钟 例如-15 (代表15分钟之内)
offlineStatus 失联状态 Integer N 1 是 ,0 否
groupIds 用户组ID String N  多个ID之间用逗号(,) 分割
offset 查询起始索引 Integer N 默认为0
limit 查询结果最多返回记录数 Integer N 默认为50
q 查询条件 String

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
deviceId 设备Id Long
type 设备类型 Integer 1Android 2ios
deviceType 设备型号 Integer 10 Android Phone ,11 Android Pad ,20 iPhone ,21 iPad  ,22 iPad MINI ,23 iPod Touch
relationship 归属 Integer 1 企业,2 员工,3 其他
deviceNumber 设备编号 String
deviceName 设备名称 String
status 设备状态 Integer 0 已淘汰 1 未激活 2 已激活设备,3已丢失设备,4 已擦除设备,5待擦除设备 6,待淘汰设备
model 设备型号 String
userId 用户Id Long
loginId 登录名 String
userName 用户名 String
mail 邮件 String
mobile 手机号码 String
groupId 用户组ID Long
groupName 用户组名 String
serialNum 设备序列号 String
imei IMEI String
imsi 国际移动用户识别码 String
activateTime 激活时间 String
lastOnlineTime 上次在线时间 String
rootFlag 是否root或者越狱 Integer 1 是 ,0 否
os 操作系统平台 String
specialTypeFlag 特殊设备类型标识. Integer 0–普通设备;100–SamSung SAFE设备;101–SamSung KNOX设备
knoxstatus knox状态 Integer knox状态,0–不支持;201–支持未注入;202–SAFE license已注入;203–KNOX license已注入;101–已创建;501–锁定
remark 设备备注 String
scanStatus 安全状态 Number 0有病毒设备,1安全设备,2未扫描
effectivePolicyCount 已生效的策略总数 Number
totalPolicyCount 下发的策略总数 Number
versionNum

OS版本号

 

String
violationCauses 违规原因 String 多个原因之间用(,)逗号分割  101 -必装应用没有装 ,102-装了黑名单的应用,103-装了白名单外的应用,104-应该安装而没有安装或者安装失败的策略,105 -违反了合规策略
offlineStatus 失联状态 Integer 1 是 ,0 否
productname 产品类型 String
udid 识别码 String
policyStatus 策略状态 String 例如0/2 已安装/已下发
eliminateTime 淘汰时间 Long
registTime 注册时间 Long
sdSerialNum SD卡序列号 String

调用示例

GET /devices?access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK
{
  "returnCode": 0,
  "total": 1,
  "rows": [
      {
      "deviceId": 146,
      "type": 2,
      "deviceType": 21,
      "relationship": 1,
      "deviceNumber": null,
      "deviceName": "caa_iPad",
      "status": 2,
      "model": "MC705CH",
      "userId": 71,
      "loginId": "caa",
      "userName": "caa",
      "mail": "aaa@com.cn",
      "mobile": "",
      "groupId": -2,
      "groupName": "默认组",
      "serialNum": "DMPJ2CZ7DJ8T",
      "imei": null,
      "os": "iPhone OS",
      "specialTypeFlag": 0,
      "knoxstatus": 0,
      "activateTime": 1451846300000,
      "lastOnlineTime": 1452096003000,
      "rootFlag": 0,
      "remark": null,
      "scanStatus": null,
      "effectivePolicyCount": 0,
      "totalPolicyCount": 0,
      "violationCauses": "103",
      "versionNum": "9.2"
    }
  ]
}

5. 获取用户的设备列表

描述

根据用户ID获取设备列表

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
userId 用户ID Long Y
status 设备状态 Integer N 0 已淘汰 1 未激活 2 已激活设备,3已丢失设备,4 已擦除设备,5待擦除设备 6,待淘汰设备

输出说明

输出参 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
deviceId 设备Id Long
type 设备类型 Integer 1Android 2ios
deviceType 设备型号 Integer 10 Android Phone ,11 Android Pad ,20 iPhone ,21 iPad  ,22 iPad MINI ,23 iPod Touch
relationship 归属 Integer 1 企业,2 员工,3 其他
deviceNumber 设备编号 String
deviceName 设备名称 String
status 设备状态 Integer 0 已淘汰 1 未激活 2 已激活设备,3已丢失设备,4 已擦除设备,5待擦除设备 6,待淘汰设备
model 设备型号 String
userId 用户Id Long
loginId 登录名 String
userName 用户名 String
mail 邮件 String
mobile 手机号码 String
groupId 用户组ID Long
groupName 用户组名 String
serialNum 设备序列号 String
imei IMEI String
activateTime 激活时间 String
lastOnlineTime 上次在线时间 String
rootFlag 是否root或者越狱 Integer 1 是 ,0 否
os 操作系统平台 String
specialTypeFlag 特殊设备类型标识. Integer 0–普通设备;100–SamSung SAFE设备;101–SamSung KNOX设备
knoxstatus knox状态 Integer knox状态,0–不支持;201–支持未注入;202–SAFE license已注入;203–KNOX license已注入;101–已创建;501–锁定
remark 描述 String
scanStatus 安全状态 Number 0有病毒设备,1安全设备,2未扫描
effectivePolicyCount 已生效的策略总数 Number
totalPolicyCount 下发的策略总数 Number

调用示例

GET  /users/{userId}/devices?access_token=xxx   {userId}代表需要查询详情的用户id
输出
HTTP/1.1 200 OK
[
    {
      "deviceId": 129,
      "type": 1,
      "deviceType": 10,
      "relationship": 1,
      "deviceNumber": "1",
      "deviceName": "caolei11-devices",
      "status": 0,
      "model": "SM-N9108V",
      "userId": 40,
      "loginId": "caolei11",
      "userName": "caolei11",
      "mail": "caolei11@qq.com",
      "mobile": "",
      "groupId": -2,
      "groupName": "默认组",
      "serialNum": "RV8FB0N90QD",
      "imei": "354782063051333",
      "os": "Android",
      "specialTypeFlag": 101,
      "knoxstatus": 201,
      "activateTime": "2015-12-09 11:22:18",
      "lastOnlineTime": 1450940072000,
      "rootFlag": 0,
      "remark": null,
      "scanStatus": null,
      "effectivePolicyCount": null,
      "totalPolicyCount": null
    }
  ]

6. 锁定设备

描述

根据设备ID锁定设备

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔
lockPassword 锁定密码 String N 单个Android设备该参数有效

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/lock?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113"
}
输出
HTTP/1.1 200 OK

7. 清除密码

描述

根据设备ID清除设备密码

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/passwordClean?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113"
}
输出
HTTP/1.1 200 OK

8. 擦除数据

描述

根据设备ID擦除数据

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔
eraseDataType 擦除数据类型 String Y 26仅擦除企业数据  25 擦除全部数据
formatSDcard sd卡是否擦除 String N 0不擦除sd卡,1擦除(Android 2.3 该项可用)

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/eraseData?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113",
"eraseDataType":"26"
}
输出
HTTP/1.1 200 OK

9. 淘汰设备

描述

根据设备ID淘汰设备

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔
eraseDataType 擦除数据类型 String Y 26仅擦除企业数据  25 擦除全部数据
formatSDcard sd卡是否擦除 String N 0不擦除sd卡,1擦除(Android 2.3 该项可用)
eliminateCauses 淘汰原因 String Y

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/eliminateDevice?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113",
"eraseDataType":"26",
"eliminateCauses":"淘汰原因"
}
输出
HTTP/1.1 200 OK

10. 定位设备

  • (1)发送设备定位指令

描述

根据设备Id 发送定位指令返回位置信息的ID

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
locationIds 位置ID String 多个直接用(,)分割

调用示例

PUT /devices/commands/location?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
    "deviceIds":"132"
}
输出
HTTP/1.1 200 OK
 {
  "locationIds": "554"
}
  •  (2)获取设备位置

描述

根据设备位置ID获取位置信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
locationIds 位置ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
locations 位置ID

输出参数 参数含义 备注
id 位置ID
udid 设备唯一标识码
uuid 指令uud
createTime 指令下发时间
updateTime 执行完成更新时间
status 状态 0:指令下发未执行;1:执行成功;21–执行失败
longitude 经度
latitude 纬度
deviceId 设备ID
deviceName 设备名称

调用示例

GET  /devices/positionInfo?locationIds=542&access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK
{
  "locations": [
    {
      "id": 542,
      "udid": "f340a7cc863116896812486d1533515031f6a08c",
      "uuid": "31bce923-54ea-45d7-b4f6-1b80cdd1d56e",
      "createTime": "2016-02-19 14:48:28",
      "updateTime": "2015-12-25 13:07:58",
      "status": 0,
      "longitude": 39.957674,
      "latitude": 0,
      "deviceId": 130,
      "deviceName": "wangshan_Android"
    }
  ]
}

11. 发送消息

描述

根据设备ID给指定设备发送 邮件或者发送消息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔
sendType 发送类型 String Y 0001 通知,0002 邮件
msgTitle 消息标题 String N 发送邮件时,须填写此项
msgContent 消息内容 Sting Y

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/sendMessage?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113",
"sendType":"0001",
"msgTitle":"test",
"msgContent":"test"
}
输出
HTTP/1.1 200 OK

12. 更新设备

描述

根据设备ID刷新设备信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/deviceRefresh?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

13. 播放铃声

描述

根据设备ID播放铃音

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个设备ID 之间用英文(,)分隔

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/ring?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceIds":"113"
}
输出
HTTP/1.1 200 OK

14. 修改设备名称

描述

根据设备ID编辑设备名称信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID Integer Y
deviceName 设备名称 String Y

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/{deviceId}/reviseDeviceName?access_token=cb906b1359ab4768a45c18d608a3c2e1
PUT /devices/113/reviseDeviceName?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceName":"设备名称"
}
输出
HTTP/1.1 200 OK

15. 标记丢失/找回

描述

根据设备ID标记设备的丢失或者找回 (如果该设备的当前状态为丢失,执行该方法的结果为标记找回,否则为标记丢失)

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID Long Y
lockPassword 锁定密码 String N

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT /devices/commands/markMissing?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入
Content-Type:application/json;charset=UTF-8
{
"deviceId":113,
"lockPassword":"锁定密码"
}
输出
HTTP/1.1 200 OK

16. 远程重启

描述

根据设备ID进行远程重启

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/reboot?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

17. 锁定容器(KNOX)

描述

根据设备ID KNOX 锁定

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/lockKnox?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

18. 移除容器(KNOX)

描述

根据设备ID KNOX擦除

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/knoxRemove?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

19. 清除密码(KNOX)

描述

根据设备ID 清除KNOX密码

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/knoxPwdClean?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

20. 发送License(KNOX)

描述

根据设备ID发送三星KNOX license

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceIds 设备ID String Y 多个ID之间用(,)分割

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

PUT  /devices/commands/knoxLicense?access_token=cb906b1359ab4768a45c18d608a3c2e1
{
"deviceIds":"1"
}
输出
HTTP/1.1 200 OK

21. 设备日志上传

描述

客户端接收到上传日志指令后,回传日志

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
设备不支持wifi上传日志 notwifi 设备不支持wifi上传日志 Integer Y 值为 1
fileName 文件名称 Sting Y 如果notwifi 为1 此参数为必填项
设备支持wifi上传日志 beginTime 开始时间 String Y 格式为 yyyy-MM-dd HH:mm:ss
endTime 结束时间 String Y 格式为 yyyy-MM-dd HH:mm:ss
enableWifi 是否仅在Wifii情况下下载 Integer Y 0否 1 仅wifi
uploadedFile 文件域 MultipartFile Y

说明:如果设备不支持wifi上传日志 notwifi 和fileName 参数必填参数, 否则 beginTime、endTime、enableWifi、uploadedFile 为必填项

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer  执行失败才返回

调用示例

POST  /devices/uploadLogFile?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
Content-Type: multipart/form-data
输出:
HTTP/1.1 200 OK 

22. 删除未激活设备

描述

根据设备ID删除未激活或者已擦除的设备

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID Integer Y

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回

调用示例

DELETE /devices/{deviceId}?access_token=cb906b1359ab4768a45c18d608a3c2e1
DELETE /devices/113?access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK

23. 获取设备的历史轨迹

描述

根据设备位置ID获取位置信息

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID String Y
beginTime 开始时间 String Y 格式为 yyyy-MM-dd HH:mm:ss
endTime 结束时间 String Y 格式为 yyyy-MM-dd HH:mm:ss

输出说明

输出参数 参数含义 类型 备注
errorCode 错误码 Integer 执行失败才返回
locations 位置ID

输出参数 参数含义 备注
id 位置ID
udid 设备唯一标识码
uuid 指令uud
createTime 指令下发时间
updateTime 执行完成更新时间
status 状态 0:指令下发未执行;1:执行成功;21–执行失败
longitude 经度
latitude 纬度
deviceId 设备ID
deviceName 设备名称

调用示例

GET  /devices/{deviceId}/historyLocations?access_token=cb906b1359ab4768a45c18d608a3c2e1
GET  /devices/113/historyLocations?access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK
{
"locations": [
{
"id": 542,
"udid": null,
"uuid": null,
"createTime": null,
"updateTime": "2015-12-25 13:07:58",
"status": 0,
"longitude": 39.957674,
"latitude": 0,
"deviceId": 130,
"deviceName": "wangshan_Android"
}
]
}