MIUI论坛 下载APP

社区版主

鸭梨山大

Rank: 7Rank: 7Rank: 7

积分
30214
机型
MOTO XT910
签到次数
21
MIUI版本
V7.1.5.0.KXGCNCK
私信

万圣节勋章MIUI 3000万MIUI 2000万1000万用户纪念勋章MIUI 7MIUI五周年MIUI三周年百万壁纸关注微信极客勋章疾风测评勋章关注腾讯微博关注新浪微博MIUI 100周发烧友俱乐部MIUI六周年

[活动通知] 小米应用开发者文档:应用自动发布接口 v1.0

[复制链接]
4160 5 |
2013-11-14 21:30 | 来自PC
| |
|
跳转
本帖最后由 Yeatshuai 于 2013-11-14 21:34 编辑

应用自动发布接口 v1.0 (MiAutoPublish API v1.0)作用

本套接口用于开发者通过接口方式向小米应用商店同步推送apk 包,包括应用查询接口、应用类别查询接口、应用推送接口;开发者可以通过该套接口提交新应用、更新应用版本和修改应用信息。

协议

1、采用协议:HTTP1.1,所有请求均使用POST 方式;
2、数据格式:请求应答数据均使用JSON 格式,采用UTF-8 编码;
3、对于需要明确传递请求参数的接口,要求进行安全验证。此时请求中需要传递的参
数:
  • 使用RequestData 参数传递请求的JSON 字符串,具体格式见各个接口定义
  • 附件按照具体接口的规定传递
  • 使用SIG 参数传递请求参数的数字签名

4、SIG 数字签名的生成方法:
  • 计算每个参数计算MD5 值(若参数为文件则计算整个文件的MD5 值)
  • 将各个参数及其对应的MD5 值按照下面示例格式组成JSON 数组,同时传递接口平台分配的访问密码
  • 使用小米应用商店分配的公钥对步骤2)生成的JSON 串进行RSA 数字签名,RSA 签名使用RSA/NONE/PKCS1Padding 方式
  • 将生成的数字签名转换为小写16 进制字符串

示例:

{“password”:”访问密码”,
“sig”:[
{"name":"parameterName1","hash":"MD5(parameterValue1)"},
{"name":"parameterName2","hash":"MD5(parameterValue2)"}]}

接口1、应用包查询接口:

通过应用包名查询小米应用商店内本账户推送的最新应用详情,用于判断是否需要进行应用推送。

请求地址:/dev/query请求参数:

参数名
可选性
类型
说明
packageName
必选
string
应用包名
userName
必选
string
用户名,在小米开发者站登陆的邮箱。
请求示例:

{“packageName”:”应用包名”,”userName”:”开发者站登录邮箱帐号”}

返回结果:

参数名
可选性
类型
说明
result
必选
int
0:表示成功,非0 表示查询失败,其中-7 表示包名被其他开发者占用,需要进行认领
可选
可选
object
应用包详细信息,如果为空表示不存在相应包
create
可选
boolean
是否允许新增该包名的应用
updateVersion
可选
boolean
是否允许应用版本更新
updateInfo
可选
boolean
是否允许应用信息更新
message
可选
string
响应消息
若为正常响应则可为空,若非正常响应则返回错误信息
应用包实体:

参数名
类型
说明
appName
string
应用名
versionName
string
版本名
versionCode
long
版本号
packageName
string
包名

应答示例:

{“result”:0,
“updateVersion”:false,
“updateInfo”:false,
“create”:false,
“message”:”查询成功”,
“packageInfo”:{
“appName”:”应用名称”,
“packageName”:”应用包名”,
“versionCode”:4,
“versionName”:”1.1.1″}
}

2、应用类别查询接口

查询小米应用商店的应用分类。

请求地址:/dev/category请求参数:<无>返回结果(JSON 字符串):

参数名
可选性
类型
说明
result
必选
int
0:表示成功,非0 表示查询失败
message
可选
string
响应消息
若为正常响应则可为空,若非正常响应则返回错误信息
categories
可选
list
应用分类列表,若非正常响应可以为空

应用分类实体:

参数名
类型
说明
categoryId
string
分类id
categoryName
string
分类名称

应答示例:

{“result”:0,”message”:”查询成功”,
“categories”:[
{"categoryId":1,"categoryName":"理财"},
{"categoryId":2,"categoryName":"聊天与社交"},
{"categoryId":3,"categoryName":"旅行与交通"},
{"categoryId":4,"categoryName":"生活"},
{"categoryId":5,"categoryName":"实用工具"},
{"categoryId":6,"categoryName":"摄影摄像"},
{"categoryId":7,"categoryName":"图书与阅读"},
{"categoryId":8,"categoryName":"体育运动"},
{"categoryId":9,"categoryName":"时尚与购物"},
{"categoryId":10,"categoryName":"效率办公"},
{"categoryId":11,"categoryName":"新闻"},
{"categoryId":12,"categoryName":"学习与教育"},
{"categoryId":13,"categoryName":"娱乐消遣"},
{"categoryId":14,"categoryName":"医疗与健康"},
{"categoryId":17,"categoryName":"动作冒险"},
{"categoryId":16,"categoryName":"策略"},
{"categoryId":19,"categoryName":"角色扮演"},
{"categoryId":18,"categoryName":"竞速"},
{"categoryId":21,"categoryName":"体育运动"},
{"categoryId":20,"categoryName":"棋牌"},
{"categoryId":23,"categoryName":"益智解密"},
{"categoryId":22,"categoryName":"音乐游戏"},
{"categoryId":25,"categoryName":"飞行模拟"},
{"categoryId":27,"categoryName":"影音视听"},
{"categoryId":26,"categoryName":"重力感应"}]}

3、应用推送接口

推送应用到小米应用商店。

请求地址:/dev/push请求参数:

参数名
可选性
类型
说明
userName
必选
string
用户名,在小米开发者站登录的邮箱
synchroType
必选
int
更新类型:0=新增,1=更新包,2=内容更新
appInfo
必选
string
JSON 字符串
apk
可选
file
Apk 包,更新类型为新增和更新时必传
icon
可选
file
应用图标,可选
screenshot_1
可选
file
应用的第1 幅截图,synchroType=0 时必选
screenshot_2
可选
file
应用的第2 幅截图,synchroType=0 时必选
screenshot_3
可选
file
应用的第3 幅截图,synchroType=0 时必选
screenshot_4
可选
file
应用的第4 幅截图,可选,截图显示顺序为1-5
screenshot_5
可选
file
应用的第5 幅截图,可选

应用包实体:

参数名
可选性
类型
说明
appName
必选
string
应用名称
packageName
必选
string
包名
publisherName
可选
string
开发者名称,不传默认使用开发者站注册的名称
versionName
可选
string
版本名,默认使用apk 中的VersionName
category
必选

应用分类(为从appstore 拉取的类型id) 新增synchroType=0 时必选
keyWords
必选
string
应用搜索关键字,空格分隔,新增时必选
desc
必选
string
应用介绍,新增时必选
updateDesc
可选
string
更新说明,当为更新应用时必选
shortDesc
可选
string
简单介绍
web
可选
string
应用的官网
price
可选
double
价格

请求示例:

{“userName”:”开发者站登录邮箱帐号”,
“synchroType”:1,
“appInfo”:{
“appName”:”应用名称”,
“category”:2,
“desc”:”应用详情”,
“keyWords”:”关键字1 关键字2″,
“packageName”:”应用包名”,
“price”:”",
“publisherName”:”发布者名称”,
“shortDesc”:”",
“updateDesc”:”版本更新日志”,
“versionName”:”版本名称”,
“web”:”应用的官网”}
}

返回结果:

参数名
可选性
类型
说明
result
必选
int
返回码:0 表示成功,非0 表示推送失败
message
可选
string
响应消息
若上传成功则可为空,否则返回错误信息
应答示例:

{“result”:0,”message”:”操作成功”}

PDF全文下载: 小米应用商店自动上传接口说明.zip (149.21 KB, 下载次数: 73)
收藏2 分享  

主题酷玩组

>>忽略这头衔吧<<

Rank: 6Rank: 6

积分
35999
机型
小米Max-高配全网通版
签到次数
183
MIUI版本
9.6.27
私信

国庆勋章MIUI 3000万MIUI 2000万1000万用户纪念勋章MIUI三周年关注微信关注腾讯微博关注新浪微博

2013-11-14 21:31 | 来自PC
|
支持一下下~

已有 1 人评分 经验 理由  

Yeatshuai + 4 MIUI 因你更精彩!

经验 +4  查看全部评分

玩机大师

Rank: 4

积分
1095
机型
小米手机2/2S
签到次数
0
MIUI版本
0
私信
2013-12-28 21:05 | 来自PC
|
好资料,支持了

玩机之王

Rank: 5Rank: 5

积分
4301
机型
未知设备
签到次数
91
MIUI版本
5.10.8
私信

MIUI 7关注微信极客勋章

2013-12-28 23:07 | 来自PC
|
看看看看看看

玩机大师

Rank: 4

积分
636
机型
小米手机4
签到次数
12
MIUI版本
V8.1.3.0.MXDCNDI
私信

APP 1000万小火箭勋章

2016-2-7 08:09 | 通过手机发布
|
我就想你们帮我搞下机子!被黑了它自己上传文件

玩机大师

Rank: 4

积分
1817
机型
未知设备
签到次数
109
MIUI版本
V10.3.2.0.PEACNXM
私信
2018-7-9 18:36 | 来自PC
|
好资料,支持了
快速回复 返回顶部 返回列表