能力接入准备:查看
开发文档
1. createApp(创建APP)
基本信息
Path: /v2/appstore/appstore/createApp
Method: POST
接口描述:
创建APP
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
app_name | string | 必须 | app名称 | ||
icon_url_uuid | string | 必须 | 图标唯一标识。默认取apk中解析到的图标 | ||
pic_vertical_screen_uuid | string [] | 必须 | 应用竖屏截图的uuid。例:[“uuid1″,”uuid2”]。通过上传图片文件即可获取uuid | item 类型: string | |
├─ | 非必须 | ||||
pic_horizontal_screen_uuid | string [] | 必须 | 应用横屏截图的uuid。例:[“uuid1″,”uuid2”]。通过上传图片文件即可获取uuid | item 类型: string | |
├─ | 非必须 | ||||
apk_uuid | string | 必须 | 上传apk后得到的唯一标识。 | ||
app_introduction | string | 必须 | 应用简介,最少10个字符 | ||
cf_id | string | 必须 | 应用分类id。 | ||
terminals | string [] | 必须 | 使用机型 [“T1”,”V2″…](机型名称) | item 类型: string | |
├─ | 非必须 | ||||
area | string [] | 必须 | 国家地区(数组)1中国大陆2港澳台3海外。例:[1,2,3] | item 类型: string | |
├─ | 非必须 | ||||
range | number | 必须 | 可见范围:0全部可见(默认),1本渠道可见 | ||
deployment_type | string | 必须 | 部署方式:1 目前只支持全部部署 | ||
language | object [] | 必须 | 应用对于不同语言的不同名称。如果apk中有设置,那么仍需要在这里填写 | item 类型: object | |
├─ lan_id | string | 必须 | 语言id | ||
├─ name | string | 必须 | 名称 | ||
language_introduction | object [] | 必须 | item 类型: object | ||
├─ lan_id | string | 必须 | 语言id | ||
├─ introduction | string | 必须 | 简介 | ||
remarks | string | 必须 | 备注 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | 1 成功 15000 系统异常 13011 iconUrl检测不通过 13010 竖屏图片检测不通过 13009 横屏图片检测不通过 13002 应用包已存在 13012 应用分类不合法 13013 适配机型信息存在不合法内容 | ||
msg | string | 必须 | |||
data | string | 必须 |
1.1 getClassifyList(获取应用分类列表)
基本信息
Path: /v2/appstore/appstore/app/getClassifyList
Method: POST
接口描述:
获取应用分类列表
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
lan_type | number | 必须 | 语言类型,1中文,2是英文 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | code码 | mock: 1 | |
data | object [] | 必须 | 分类数组 | item 类型: object | |
├─ cf_id | string | 必须 | 分类id | ||
├─ cf_name | string | 必须 | 分类名字 | ||
msg | string | 必须 | 返回消息内容 | mock: “” |
1.2 getLanguageList(获取国家编码列表)
基本信息
Path: /v2/appstore/appstore/app/getLanguageList
Method: POST
接口描述:
获取国家语言编码列表
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | code码 | mock: 1 | |
data | object [] | 必须 | item 类型: object | ||
├─ lan_id | string | 必须 | 语言编码id | ||
├─ code | string | 必须 | 语言编码 | ||
├─ zn | string | 必须 | 中文解释 | ||
├─ en | string | 必须 | 英文解释 | ||
msg | string | 必须 | 返回信息 |
1.3 getTerminalList(获取机型列表)
基本信息
Path: /v2/appstore/appstore/app/getTerminalList
Method: POST
接口描述:
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | code码 | mock: 1 | |
data | object [] | 必须 | item 类型: object | ||
├─ mm_id | string | 必须 | 机型的ID | ||
├─ name | string | 必须 | 机器的名称型号 | ||
├─ screen_type | number | 必须 | 机型是竖屏还是横屏 0竖屏 1横屏 | mock: 1 | |
msg | string | 必须 | 返回的信息 |
2. removeApp(删除一个app)
基本信息
Path: /v2/appstore/appstore/app/removeApp
Method: POST
接口描述:
删除一个app应用
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
x-timestamp | 是 | x-timestamp (Only:undefined) | ||
x-sign | 是 | x-sign (Only:undefined) | ||
x-nonce | 是 | x-nonce (Only:undefined) | ||
x-appid | 是 | x-appid (Only:undefined) |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
package_name | string | 必须 | 包名 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | 返回码 | ||
data | string | 必须 | 默认空 | ||
msg | string | 必须 | 返回的信息 |
3.upgradeAppVersion(升级一个app版本)
基本信息
Path: /v2/appstore/appstore/app/upgradeAppVersion
Method: POST
接口描述:
app版本的升级
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
x-timestamp | 是 | x-timestamp (Only:undefined) | ||
x-sign | 是 | x-sign (Only:undefined) | ||
x-nonce | 是 | x-nonce (Only:undefined) | ||
x-appid | 是 | x-appid (Only:undefined) |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
package_name | string | 必须 | 包名 | ||
remarks | string | 非必须 | 备注 | ||
update_content | string | 必须 | 升级内容 | ||
update_flag | number | 必须 | 升级类型:1正版升级(默认) | ||
apk_uuid | string | 必须 | apk的标识 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | code码 | ||
data | string | 必须 | |||
msg | string | 必须 | 返回的信息 |
uploadApk(上传APK)
基本信息
Path: /v2/midplat/filecore/file/uploadApk
Method: POST
接口描述:
用于上传apk。file_type_key字段值默认为appstore_apk
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | multipart/form-data | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
file | file | 是 | ||
json | text | 是 | json格式数据 包含以下参数 | |
json.md5 | text | 是 | APK的md5 验证APK文件完整性 | |
json.file_type_key | text | 是 | 根据业务文档 确定业务类型的值 如:appstore_apk |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 非必须 | |||
msg | string | 非必须 | |||
data | object | 非必须 | |||
├─ uuid | string | 非必须 | 文件的资源标识 | ||
├─ package_name | string | 非必须 | apk的包名 | ||
├─ signature | string | 非必须 | 签名 | ||
├─ apk_size_origin | number | 非必须 | 原始包的文件大小 | ||
├─ version_code | number | 非必须 | 版本号 | ||
├─ version_name | string | 非必须 | 版本名称 | ||
├─ down_temp_url | string | 非必须 | 下载地址 |
uploadImage(上传图片)
基本信息
Path: /v2/midplat/filecore/file/uploadImage
Method: POST
接口描述:
图片上传。用于上传应用截图。
file_type_key字段值:icon:appstore_icon;横屏:appstore_hscreenshot;竖屏:appstore_vscreenshot
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | multipart/form-data | 是 | ||
sign | 是 | 加密签 sha.hmac(appkey,body) |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
file | file | 是 | ||
json | text | 是 | 除file外的参数都放到这里 {“file_type_key”:””,”md5″:””,} file_type:带业务的类型。md5:文件的MD5验证完整性 |
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | string | 必须 | |||
msg | string | 必须 | |||
data | object | 必须 | |||
├─ uuid | string | 必须 | 文件的UUID | ||
├─ temp_url | string | 必须 | 私有文件 返回临时URL | ||
├─ result | string | 必须 | json |