创建批量添加APP的任务
批量添加APP时,支持从指定网页获取APK文件。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/app/addTask
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin。 |
Body请求参数
字段 |
类型 |
必须 |
描述 |
apps |
JSON |
Yes |
JSON 格式的APP对象数组,单次请求提交的对象数量最多100个。 |
apps 请求示例
[
{
"title": "app名称",
"type": "Android",
"imageEncode": "base64EncodedString3",
"appUrl": "http://example.com/app3",
"developer": "http://example.com/developer",
"privacyUrl": "http://example.com/privacy",
"authUrl": "http://example.com/auth",
"copyrightEncode": "base64EncodedString,base64EncodedString",
"appAutoCheck": "ON",
"remark": "app描述",
}
]
apps 字段说明
字段 |
类型 |
必须 |
描述 |
title |
String |
Yes |
APP名称长度限制为 2 ~ 50 个字符 |
type |
String |
Yes |
系统类型,枚举值:Android, iOS (不区分大小写) |
imageEncode |
String |
Yes |
APP图标(图片base64编码) |
appUrl |
String |
Yes |
APP下载链接 |
appAutoCheck |
String |
No |
是否自动检测APP下载链接更新(仅限安卓APK包的下载链接使用),枚举值:ON或OFF,ON-开启; OFF-关闭,缺省值为OFF |
developer |
String |
No |
开发者名称(仅限系统类型为Android时使用,且必填) |
privacyUrl |
String |
No |
隐私协议url(仅限系统类型为Android时使用,且必填) |
authUrl |
String |
No |
用户权限url(仅限系统类型为Android时使用,且必填) |
copyrightEncode |
String |
No |
版权证明(图片base64编码,仅限系统类型为Android时使用,且必填),多张图片使用英文逗号分隔,最多可上传20张图片,文件格式为JPG、JPEG、PNG,大小不超过2M |
remark |
String |
No |
描述, 长度限制为 100 个字符以内 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'apps=[{"appId": 6790793322, "title": "app名称"}]' \
'https://api.e.360.cn/dianjing/app/addTask'
正常返回结果
{
"appTaskId": 0,
"failures": [
{
"code": 50403,
"description": "APP名称长度限制为 2 ~ 50 个字符",
"message": "标题格式或长度有误,具体限制请参考点睛平台"
}
]
}
返回结果说明
字段 |
类型 |
描述 |
appTaskId |
Number |
APP离线任务id,用于获取任务处理状态 |
failures |
Json |
失败任务详细信息 |