应用

错误码

Http Status Code errorCode desc
400 700 解析应用失败
701 应用文件没有签名
702 wrapping应用和非wrapping应用不能共存
703 存在相同包名相同版本的应用
704 存在该应用的不同版本
706 未解析到iTunes 标识符
707 输入的url非法
708 上传应用失败
709 保存应用失败
710 上传文件为空
711 应用不存在
712 应用不可用
713 没有指定推送范围
714 推送类型错误
715 安全桌面策略密码不能为空
716 应用更新失败
717 应用策略参数错误
718 应用策略保存失败
719 应用策略不存在
720 应用策略不可用
721 要改变的状态与应用策略状态一致
722 用户操作权限错误
723 重名的应用分类
724 应用分类不存在
725 文件不存在
726 下发指令失败
727 应用策略通用参数错误
728 应用策略类型不匹配
729 应用策略SSO参数错误
730 应用分类参数不在要求范围之内
731 下载失败
732 替换应用时包名不一致
733 应用策略不存在
734 有应用正在应用用此应用策略不可删除
735 安全桌面密码不能为空
736 应用策略不能为空
737 应用与所选应用策略类型不匹配
738 安全容器账号格式错误
739 安全浏览器主面不能为空
740 此应用与应用标签已关联无需再次关联
741 杀毒时间格式错误
742 应用保存时replaceOrAdd值错误
743 应用参数为空
744 调用推荐应用服务错误
745 导入推荐应用图标不存在
746 导入推荐应用文件不存在
747 推荐应用参数为空
748 普通应用策略是否开启参数为空
749 普通应用策略开启时必填参数为空
750 普通应用策略账号格式错误
751 有应用正在应用用此应用标签不可删除
752 容器应用策略白名单数据格式错误
753 容器应用策略白名单应用不存在
754 容器应用策略白名单应用有非wrapp应用
755 容器应用策略WIFISSID为空
756 容器应用策略网络控制没有指定使用的WIFI网络
757 删除应用时下发卸载指令出错
758 删除应用时删除数据库出错
759 应用策略名称已经存在
760 黑白名单名称已经存在
761 定时推送时间格式错误
762 定时推送时间小于当前时间
763 IPA应用包不能上传到公共应用中
764 标签没有关联的用户
765 应用不是安全容器应用
766 安全容器状态参数不正确

1. 上传应用

  • (1)apk、ipa应用上传

描述

上传一个安卓apk或IOS的ipa的应用(ipa应用包只能上传到企业应用),如果有同应用的其他版本时,可以再调用保存应用的接口,选择替换旧应用还是新建一个应用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
file 文件域 MultipartFile Y
type 应用分类 Integer Y 1:企业 2:公共
catesId 应用标签 String N 应用标签ID
iosOsVersion ios设备系统最低版本 String N 5.1|6.0|6.1|7.0|7.1|8.0|8.1|8.2|8.3|8.4|9.0,如果不填写默认取最小值
androidOsVersion Android设备系统最低版本 String N 2.3|3.0|3.1|3.2|4.0|4.1|4.2|4.3|4.4|5.0,如果不填写此项默认取最小值
modelType ios适用设备 String N 20-iphone 21-ipad 22-ipad mini 23-itouch(上传ios应用时如不填写 此项默认值为20,21,22,23)
Company 开发商 String N
description 描述 String N

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误
appId 应用id Long
platform 应用平台 Integer 1:安卓 2:IOS
fileName 应用名称 String
appIds 已存在的其他版本应用ID String 多个应用间用逗号分隔
versions 已存在的其他版本的版本号 String 多个版本间用逗号分隔
message 有同版本时的提示信息 Integer 704:存在该应用的不同版本
appPath 上传应用的保存路径 String
appName 应用显示名 String

调用示例:

POST  /apps/app/package?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
Content-Type: multipart/form-data
输出:
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8
{
"appId":"152",
"platform": 2
}
如果有同应用其他版本时:
{
"fileName": "7NQTest1.3.ipa",
"appIds": "153",
"versions": "1.2.0",
"message": 704,
"appPath": "/data/app//mdm/c/1/59054d46-446b-4bd9-a0b1-8ef7e3a63e7d.ipa",
"platform": 2
}
  •  (2)web应用上传

描述

以url形式上传一个IOS苹果商店手机端的应用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
itunesUrl 应用url String Y 例如:https://itunes.apple.com/cn/app/2048/id840919914?mt=8
catesId 应用标签 String N 应用标签ID
iosOsVersion ios设备系统最低版本 String N 5.1|6.0|6.1|7.0|7.1|8.0|8.1|8.2|8.3|8.4|9.0,如果不填写默认取最小值
modelType ios适用设备 String N 20-iphone 21-ipad 22-ipad mini 23-itouch(上传ios应用时如不填写 此项默认值为20,21,22,23)
description 描述 String N

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误
appId 应用id Long

调用示例:

POST  /apps/app/weburl?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
{
"itunesUrl":"https://itunes.apple.com/cn/app/2048/id840919914?mt=8",
"catesId":"2",
"iosOsVersion":"6.0",
"modelType":"1",
"description":"mmmmmmmmm"
}
输出:
HTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"appId":"152"
}

2. 编辑应用

描述

根据应用Id编辑一个应用的基本信息,包括名称、描述、开发商、最低版本要求、分类。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y
name 名称 String N
description app文件路径 String N
catesId 应用标签Id String N
osVersion 系统最低版本要求 String N
company 开发商 String N
modelType 适用设备 String N IOS应用时有此选项

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

PUT  /apps/app/{appId}?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
{"name":"test",
"description":"test update",
"company":"nationsky",
"catesId":"2"} 
输出:
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

3. 应用详情

描述

根据应用ID查询一个应用的详细信息。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误
 返回数据说明
输出参数 参数说明 类型 备注
id 应用ID
loginId 创建者
name 应用名称
pkgname 应用包名
fileName 应用文件名
version 大版本号
icon 应用图标
price 应用价格 外部ios有此价格值
appsize 应用大小 字节
sizeString 应用大小 转化为k或M
company 开发商
itunesStoreId 外部IOS应用ID 外部IOS应用有此值
platform 应用平台 1:安卓 2:IOS
source 应用路径 上传包的会传到服务器相应的路径下, URL上传的应用保存的url值
osVersion 设备最低版本要求
type 应用分类 1:企业 2:公共
description 应用描述
startTime 定时推送时间
catesId 应用标签ID
categName 应用标签名称

调用示例:

GET /apps/app/{appId}?access_token=46229672c1854533887829ab753cedc7
输入:
用实际值替换url中的appId
输出:
{
"appDetailVo": {
"id": 149,
"loginId": "admin",
"name": "美拍 - 超好玩短视频社区!可以拍5分钟视频啦!",
"pkgname": "com.meitu.mtmv",
"version": "4.3.0",
"status": 0,
"icon": null,
"type": 1,
"price": "0.0",
"appSize": 58733208,
"sizeString": "56.01M",
"company": "Xiamen Meitu Technology Co., Ltd.",
"itunesStoreId": 847334708,
"platform": 2,
"source": "https://itunes.apple.com/cn/app/mei-pai-10miao-ye-neng-pai/id847334708?mt=8",
"osVersion": null,
"description": "*美图出品,超好玩短视频社区",
"catesId": null,
"cateName": "",
"startTime": null,
"fileName": null
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

4. 推送应用

描述

把指定的应用根据用户ID、用户组 ID,推送到其相应的设备上。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y
groupIds 用户组Id Long N 数组
userIds 用户Id Long N 数组
labelIds 标签Id Long N 数组(标签和用户、用户组推送是互斥的,要么按用户、用户组推送 要么按标签推送)
distributeType 是否推送消息 Integer Y 1: 推送消息 ,2: 不推送
distributeMode 推送模式 Integer Y 0:必装、1:按需
deviceRelationship 设备所属关系 String Y 1:企业;2:员工;3:其他(多个值中间逗号分隔)
essentialApp 是否合规检测 Integer N  0 :不检测 1 :检测(推送模式为必装时才有效)
delApp 是否在淘汰设备时删除该应用 Integer N 0:不删除、1:删除
isInputKnox 是否放入KNOX容器内 Integer N 安卓应用有此选项 (0:否 1:是 )
wifi 是否只在wifi情况下下载 Integer N 安卓应用有此选项 0:所有情况下载 1:仅wifi
preventBackup 是否防止应用程序备份 Integer N IOS应用有此选项(是:1、否:0)
startTimeStr 定时推送时间 String N yyyy-MM-dd HH:mm:ss(按需时没有定时)
appconfid 应用策略ID Long N 如果是普通应用可以不填此项,如果是内置应用必须填写

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

POST  /apps/app/{appId}/push?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
{
"groupIds": [-2], 
"userIds":[35],
"distributeType": "1",
"distributeMode": "0",
"deviceRelationship": "1,2,3",
"essentialApp": "0",
"delApp": "0",
"isInputKnox": "0",
"wifi": "1",
"preventBackup":"0",
"startTimeStr":"2015-12-01 08:23:00",
"appconfid":"4"
} 
输出:
HTTP/1.1 200 OK 

5. 查找应用

描述

查询应用列表。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
search_nameOrComp 应用名称或开发商 String N 模糊查询
search_category 应用分类ID String N
search_platform 平台类型 Integer N 1:安卓 2:IOS
search_type 应用分类 Integer N 1:企业 2:公共
search_domaintype 应用类型 Integer N 0:普通应用 2:容器应用 3:内置应用

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误
返回列表中 数据说明
输出参数 参数说明 类型 备注
id 应用ID
loginId 创建者
name 应用名称
pkgname 应用包名
fileName 应用文件名
version 大版本号
icon 应用图标
price 应用价格 外部ios有此价格值
size 应用大小 字节
sizeString 应用大小 转化为k或M
company 开发商
itunesStoreId 外部IOS应用ID 外部IOS应用有此值
platform 应用平台 1:安卓 2:IOS
source 应用路径 上传包的会传到服务器相应的路径下, URL上传的应用保存的url值
type 应用分类 1:企业 2:外部
createTime 创建时间
updateTime 更新时间
description 应用描述
domainType 应用类型 解析apk 包时会区分,ios的都属普通应用。 应用类型(普通应用-0、容器应用-2 内置应用-3)
startTime 定时推送时间
versionCode 小版本号
installCount 安装设备数
pushCount 分发设备数
categoryName 应用标签名称

调用示例:

GET /apps/app?access_token=46229672c1854533887829ab753cedc7
输入:
输入查询参数
输出:
{
"total": 2,
"rows": [
{
"id": 150,
"loginId": "admin",
"name": "我要早睡",
"pkgname": "com.secretlisa.sleep",
"fileName": "6c4a6ff7-c849-40ce-8d04-2b4a433cd935.apk",
"version": "0.9.1",
"icon": "mdm/6/d/e50709bc-79f6-4b50-a5d0-7a7174123cb2.png",
"price": null,
"size": 1136939,
"sizeString": "1.08M",
"company": "",
"platform": 1,
"source": "mdm/c/d/6c4a6ff7-c849-40ce-8d04-2b4a433cd935.apk",
"downloadCount": null,
"type": 1,
"status": 0,
"createTime": "2015-12-16 15:34:11",
"updateTime": "2015-12-16 15:34:11",
"description": "",
"domainType": 0,
"startTime": null,
"versionCode": "2",
"installCount": 0,
"pushCount": 0,
"iTunesStoreId": null,
"catesId": null,
"categoryName": []
},
{
"id": 149,
"loginId": "admin",
"name": "美拍 - 超好玩短视频社区!可以拍5分钟视频啦!",
"pkgname": "com.meitu.mtmv",
"fileName": null,
"version": "4.3.0",
"icon": null,
"price": "0.0",
"size": 58733208,
"sizeString": "56.01M",
"company": "Xiamen Meitu Technology Co., Ltd.",
"itunesStoreId": 847334708,
"platform": 2,
"source": "https://itunes.apple.com/cn/app/mei-pai-10miao-ye-neng-pai/id847334708?mt=8",
"downloadCount": null,
"type": 1,
"status": 0,
"createTime": "2015-12-16 15:29:12",
"updateTime": "2015-12-16 15:29:12",
"description": "*美图出品",
"domainType": 0,
"startTime": null,
"versionCode": null,
"installCount": 0,
"pushCount": 0,
"catesId": null,
"categoryName": []
}
]
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

6. 卸载应用

描述

删除指定用户、用户组推送的应用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y
groupIds 用户组ID String N 多个值之间以逗号分隔(groupIds和userIds不能同时为空)
userIds 用户ID String N 多个值之间以逗号分隔

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

DELETE     /apps/app/{appId}/push?access_token=48a3686607a349058490ea1b528cfde7
输入:
useIds=43&groupIds=15
输出:
HTTP/1.1 200 OK

7.  删除应用

描述

根据应用ID删除一个应用,推送卸载指令给分发过的客户端,删除数据库的信息。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

DELETE     /apps/app/{appId}?access_token=48a3686607a349058490ea1b528cfde7
输入:
用实际值替换换上url里的appId
输出:
HTTP/1.1 200 OK

8. 获取设备已安装应用

描述

根据设备ID获取设备已按照的应用列表

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 String Y
deviceId 设备ID Long Y
offset 查询起始索引 Integer N 默认为0
limit 查询结果最多返回记录数 Integer N 默认为50

输出说明

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

输出参数 参数含义 备注
appId 应用ID
deviceId 设备ID
name 应用名称
packageName 包名
status 状态 0未安装 1 已安装 2可修改(自动推送) 3 开始下载 4下载失败或取消 5等待安装 6正在安装 7已安装安装完成 8用户拒绝 9用户卸载 10安装失败 11可更新 100正在安装队列中(中间状态) 200未知状态
type 分类 1 企业应用 2公共应用
size 大小
version 版本号
domainType 应用类型 普通应用-0、容器应用-2 内置应用-3
loginId 操作者
updateTime 更新时间
blackFlag 是否是黑名单应用 1 属于黑名单应用,0 不属于黑名单应用

调用示例

GET  /devices/{deviceId}/apps?access_token=cb906b1359ab4768a45c18d608a3c2e1
GET  /devices/113/apps?access_token=cb906b1359ab4768a45c18d608a3c2e1
输出
HTTP/1.1 200 OK
"total": 1,
  "rows": [
    {
"appId": null,
"deviceId": 136,
"name": "Fake GPS Location",
"packageName": "br.com.tupinikimtecnologia.fakegpslocation",
"status": null,
"type": null,
"domainType": null,
"size": null,
"version": "0.5.2",
"loginId": null,
"updateTime": null
    }
]
}

9. 获取应用分发情况

描述

查询某个应用的分发情况。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appId 应用ID Long Y
searchInput 查询参数 String N 模糊查询(姓名、账号、邮箱)
relationship 设备归属 String N 1:企业;2:员工;3:其他
installStatus 安装状态 Integer N

0 – 未安装,包括原状态中的:

(1未安装、2已分发、3正在下载、4下载失败、5等待安装、6正在安装、7用户拒绝、8用户拒绝、9用户卸载/已删除、10失败)

7 – 已安装
11 – 待更新

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

GET    /apps/app/{appId}/distribution?access_token=48a3686607a349058490ea1b528cfde7
输入:
用实际值替换url中的appId,如果有其他查询条件在url中添加 [searchInput=nation&relationship=1&installStatus=2]
输出:
HTTP/1.1 200 OK
{
"total": 1,
"rows": [
{
"loginId": "lanwei", //账号
"mail": "lanwei@q.com",
"mobile": null,
"userId": 25,
"userName": "lanwei",
"groupName": "默认组",
"groupId": -2,
"deviceId": 108,
"installStatus": 2, //安装状态 
"deviceName": "lanwei_Android", //设备名称
"deviceType": 1, //设备状态
"versioNum": "6.0", //设备系统版本
"relationship": 1,
"requiredApp": 0, //是否必装
"lastOnlineTime": "2015-12-11 10:27:50",
"updateTime": "2015-12-22 11:39:38",
"adminLoginId": "admin", //分发操作者
"pushTime": "2015-12-01 08:23:00"
}
]
}

10. 创建黑白名单

描述

管理员身份创建黑白名单。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
type 黑白名单类型 Integer Y 1:白名单,2:黑名单
platformType 平台类型 Integer Y 1:android ,2:ios
name 黑白名单名称 String Y
status 黑白名单状态 Integer Y 0:禁用, 1:启用
appName 应用名称 String Y
pkgName 程序ID(包名) String Y

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

POST  /apps/restriction?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
{
"name": "aaaa",
"type": "1",
"platformType": "1",
"description": "ccccccccccasas",
"status": "1",
"apps": [
{
"appName": "1111",
"pkgName": "111111"
},
{
"appName": "12211",
"pkgName": "12221"
}
]
} 
输出:
{
"appStrategyId": 1
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

11.  编辑黑白名单

描述

修改指定黑白名单的信息,包括修改名称、描述、应用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appStrategyId 黑白名单ID Long Y
name 名称 String N
description 描述 String N
appName 应用名称 String N
pkgName 程序ID(包名) String N

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

PUT   /apps/restriction/{appStrategyId}?access_token=8c8acbd3eed546609d4cdd4b81a2ba8b
输入:
{
"name": "333",
"description": "bbbbbbbbbsas",
"apps": [
{
"appName": "124",
"pkgName": "123"
},
{
"appName": "125",
"pkgName": "124"
}
]
}
输出:
HTTP/1.1 200 OK 

12. 推送黑白名单

描述

管理员身份根据用户组ID或用户ID推送指定的黑白名单。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appStrategyId 黑白名单ID Long Y
pushDeviceType 推送设备归属 String Y 1-企业;2-员工;3-其他(多个值中间逗号分隔)
groupIds 用户组ID Long N 数组
userIds 用户ID Long N 数组
labelIds 标签ID Long N 数组(标签推送和用户、用户组推送是互斥的,要么按 用户、用户组推送,要么按标签推送。)

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

POST  /apps/restriction/{appStrategyId}/push?access_token=cb906b1359ab4768a45c18d608a3c2e1
输入:
{
"pushDeviceType":"1,2,3",
"groupIds":[-2],
"userIds":[291]
}
输出:
HTTP/1.1 200 OK 

13. 查询黑白名单

描述

查询黑白名单列表,可以根据名称、描述、类型查询。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
name 名称或创建者 String N 模糊查询
type 类型 Integer N 1:白名单,2:黑名单
platformType 平台类型 Integer N 1:安卓 2:IOS
status 状态 Integer N 0:禁用 1:启用

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误
返回参数
输出参数 参数说明 备注
id 黑白名单ID
name 黑白名单名称
description 描述
type 黑白名单类型 1:白名单,2:黑名单
platformType 平台类型 1:安卓 2:IOS
pushDeviceType 设备归属 1-企业;2-员工;3-其他(多个值中间逗号分隔)
status 黑白名单状态 1:启用 0:禁用
createTime 创建时间
loginId 创建者
updateTime 更新时间
appName 应用名称
pkgName 应用包名

 

 

调用示例

GET   /apps/restriction/{appStrategyId}?access_token=8c8acbd3eed546609d4cdd4b81a2ba8b
输入:
输入查询参数
输出:
{
"total": 7,
"rows": [
{
"id": 9,
"name": "black",
"description": "",
"type": 2,
"platformType": 2,
"pushDeviceType": "1,2,3",
"status": 1,
"createTime": 1449208017000,
"loginId": "admin",
"updateTime": 1449208017000,
"distType": 0,
"apps": [
{
"appName": "com.wlxq2.baijiajiangtandaquan",
"pkgName": "com.wlxq2.baijiajiangtandaquan"
}
]
},
{
"id": 8,
"name": "娱乐黑名单",
"description": "",
"type": 2,
"platformType": 2,
"pushDeviceType": "1,2,3",
"irrePushFlag": 1,
"status": 0,
"createTime": 1449199388000,
"loginId": "admin",
"updateTime": 1449199388000,
"updateBy": null,
"distType": 0,
"apps": [
{
"appName": "最美应用",
"pkgName": "com.brixd.niceapps"
}
]
},
{
"id": 7,
"name": "娱乐应用-白名单",
"description": "娱乐应用-白名单",
"type": 1,
"platformType": 2,
"pushDeviceType": "1,2,3",
"irrePushFlag": 1,
"status": 0,
"createTime": 1449199139000,
"loginId": "admin",
"updateTime": 1449199139000,
"updateBy": null,
"distType": 0,
"apps": [
{
"appName": "最美应用",
"pkgName": "com.brixd.niceapps"
}
]
}
]
}
]
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

14. 启用禁用黑白名单

描述

根据黑白名单ID对黑白名单进行启用禁用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appStrategyId 黑白名单ID Long Y
status 黑白名单状态 Integer Y 0:禁用 1:启用

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

PUT     /apps/restriction/{appStrategyId}/status?access_token=c0d0eb2701574544bef867eea7830d8a
输入:
输入参数:status=0
输出:
HTTP/1.1 200 OK 

15. 删除黑白名单

描述

根据黑白名单ID删除一个黑白名单,推送卸载指令给分发过的客户端,删除数据库的信息。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appStrategyId 黑白名单ID Long Y

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例

DELETE     /apps/restriction/{appStrategyId}?access_token=c0d0eb2701574544bef867eea7830d8a
输入:
用实际值替换url中appStrategyId
输出:
HTTP/1.1 200 OK 

16. 创建应用标签

描述

创建一个应用标签,可以选择哪些应用属于这个标签。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
name 应用标签名称 String Y  不可以重名
description 应用标签描述 String N
appIds 应用ID数组 String Y

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

POST    /apps/category?access_token=f904d32cccc44e9cbf38c7b575533cb3
输入:
{
"name":"分类3",
"description":"aaaaa",
"appIds":[145,141]
}
输出:
{
"appCategoryId": 1
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

17. 查询应用标签

描述

查询应用标签列表,可以根据名称、类型查询。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
name 名称 String N

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

GET /apps/category?access_token=f904d32cccc44e9cbf38c7b575533cb3
输入:
输入查询参数
输出
{
"total": 1,
"rows": [
{
"id": 47,
"name": "分类3",
"description": "aaaaa",
"parentId": null,
"createTime": 1449546292000,
"updateTime": 1449546292000,
"loginId": "admin",
"appIds": null,
"appList": [
{
"appId": 145,
"name": "我要早睡"
},
{
"appId": 141,
"name": "安全容器"
}
]
}
]
}
HTTP/1.1 200 OK 
Content-Type:application/json;charset=UTF-8

18. 编辑应用标签

描述

根据应用标签ID,编辑应用标签信息,可编辑名称、描述、所选应用。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appCategoryId 应用标签ID Long Y
name 名称 String N
appIds 应用ID数组 String N
description 应用标签描述 String N

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

PUT /apps/category/{appCategoryId}?access_token=f904d32cccc44e9cbf38c7b575533cb3
输入:
{
"name":"分类55",
"description":"aaaaa",
"appIds":[145,141]
}
输出
HTTP/1.1 200 OK 

19. 删除应用标签

描述

根据应用标签ID,删除应用分类信息, 如果有应用正在使用此标签不可删除。

输入说明

输入参数 参数含义 类型 必填 备注
access_token 访问令牌 string Y
appStrategyIds 应用分标签ID Long Y 多个值之间逗号分隔

输出说明

输出参数 参数说明 类型 备注
errorCode 错误码 Integer 执行错误

调用示例:

DELETE /apps/category/{appCategoryIds}?access_token=f904d32cccc44e9cbf38c7b575533cb3
输入:
用实际值替换url中的appCategoryIds
输出
HTTP/1.1 200 OK