本文為小米應(yīng)用商店的應(yīng)用自動(dòng)發(fā)布接口操作指南,您可在了解內(nèi)容后,自行操作應(yīng)用自動(dòng)發(fā)布。
一、作用
本套接口用于開發(fā)者通過(guò)接口方式向小米應(yīng)用商店同步推送apk包,包括應(yīng)用查詢接口、應(yīng)用類別查詢接口、應(yīng)用推送接口;開發(fā)者可以通過(guò)該套接口提交新應(yīng)用、更新應(yīng)用版本和修改應(yīng)用信息。
二、協(xié)議
1、采用協(xié)議
HTTP1.1,所有請(qǐng)求均使用POST方式;
2、數(shù)據(jù)格式
請(qǐng)求應(yīng)答數(shù)據(jù)均使用JSON格式,采用UTF-8編碼;
3、傳遞請(qǐng)求參數(shù)
對(duì)于需要明確傳遞請(qǐng)求參數(shù)的接口,要求進(jìn)行安全驗(yàn)證。此時(shí)請(qǐng)求中需要傳遞的參數(shù):
·使用RequestData參數(shù)傳遞請(qǐng)求的JSON字符串,具體格式見各個(gè)接口定義
·附件按照具體接口的規(guī)定傳遞
·使用SIG參數(shù)傳遞請(qǐng)求參數(shù)的數(shù)字簽名
4、SIG數(shù)字簽名的生成方法
·計(jì)算每個(gè)參數(shù)計(jì)算MD5值(若參數(shù)為文件則計(jì)算整個(gè)文件的MD5值)
·將各個(gè)參數(shù)及其對(duì)應(yīng)的MD5值按照下面示例格式組成JSON數(shù)組,同時(shí)傳遞接口平臺(tái)分配的訪問(wèn)密碼
·使用小米應(yīng)用商店分配的公鑰對(duì)步驟2)生成的JSON串進(jìn)行RSA數(shù)字簽名,RSA簽名使用RSA/NONE/PKCS1Padding方式
·將生成的數(shù)字簽名轉(zhuǎn)換為小寫16進(jìn)制字符串
示例:{"password":"訪問(wèn)密碼","sig":[{"name":"parameterName1","hash":"MD5(parameterValue1)"},{"name":"parameterName2","hash":"MD5(parameterValue2)"}]}
三、接口
地址:https://api.developer.xiaomi.com/devupload
1、應(yīng)用包查詢接口
通過(guò)應(yīng)用包名查詢小米應(yīng)用商店內(nèi)本賬戶推送的最新應(yīng)用詳情,用于判斷是否需要進(jìn)行應(yīng)用推送。
1)、請(qǐng)求地址:/dev/query
2)、請(qǐng)求參數(shù):
3)、請(qǐng)求示例:
{"packageName":"應(yīng)用包名","userName":"開發(fā)者站登錄郵箱帳號(hào)"}
4)、返回結(jié)果:
5)、應(yīng)用包實(shí)體:
6)、應(yīng)答示例:
{"result":0,"updateVersion":false,"updateInfo":false,"create":false,"message":"查詢成功","packageInfo":{"appName":"應(yīng)用名稱","packageName":"應(yīng)用包名","versionCode":4,"versionName":"1.1.1"}}
2、應(yīng)用類別查詢接口
查詢小米應(yīng)用商店的應(yīng)用分類。
1)、請(qǐng)求地址:/dev/category
2)、請(qǐng)求參數(shù):<無(wú)>
3)、返回結(jié)果(JSON字符串):
4)、應(yīng)用分類實(shí)體:
5)、應(yīng)答示例:
3、應(yīng)用推送接口
推送應(yīng)用到小米應(yīng)用商店。
1)、請(qǐng)求地址:/dev/push
2)、請(qǐng)求參數(shù):
3)、應(yīng)用包實(shí)體:
4)、請(qǐng)求示例:
{"userName":"開發(fā)者站登錄郵箱帳號(hào)","synchroType":1,"appInfo":{"appName":"應(yīng)用名稱","category":2,"desc":"應(yīng)用詳情","keyWords":"關(guān)鍵字1關(guān)鍵字2","packageName":"應(yīng)用包名","price":"","publisherName":"發(fā)布者名稱","shortDesc":"","updateDesc":"版本更新日志","versionName":"版本名稱","web":"應(yīng)用的官網(wǎng)"}}
5)、返回結(jié)果:
以上為應(yīng)用自動(dòng)發(fā)布接口操作指南。