參數(shù)說明
id
24位字符串. 某條數(shù)據(jù)在數(shù)據(jù)庫中的唯一IDtoken
用于識別用戶身份, 如果請求不帶token 作為匿名訪問處理. token
可以在用戶信息中找到(只有上傳過應(yīng)用的用戶才具有使用開發(fā)者API的權(quán)限) 點(diǎn)擊獲取Token
版本查詢
查詢app的版本和更新信息,如果app在FIR上返回當(dāng)前信息, 如果不在,則獲取AppStore數(shù)據(jù)并返回,還沒有則返回{}
請求地址
GET
http://fir.im/api/v2/app/version/:idOrAppid
請求參數(shù)
參數(shù) | 說明 |
---|
idOrAppid | 可以是com.abc.def 反DNS形式. 因為appid可能不是唯一的(不同的用戶可能上傳了同一個app), 可以用app在FIR.im上的數(shù)據(jù)庫唯一id(24個16進(jìn)制字符)來獲取這個app的版本號. |
返回參數(shù)
參數(shù) | 說明 |
---|
version | 版本號 |
versionShort | 可讀版本號 |
update_url | 升級地址 |
changelog | 更新日志 |
查看廣場上的應(yīng)用
請求地址
GET
http://fir.im/api/v2/app/recent
請求參數(shù)
參數(shù) | 說明 |
---|
size | 可選 指定每頁最多返回數(shù)量, 默認(rèn)48條 |
page | 可選 指定返回返回頁數(shù) 默認(rèn)1 |
返回參數(shù)
返回的是一個數(shù)組, 每個元素的數(shù)據(jù)結(jié)構(gòu)如下:
參數(shù) | 說明 |
---|
count | App的數(shù)量 |
update_at | 上次更新日期 |
appid | 可以是com.abc.def 反DNS形式 也可以是284910350 的數(shù)字形式 |
short | 短地址 3~8個字符 |
version | 版本號 |
name | App名 |
icon | App圖標(biāo)地址 |
changelog | 更新記錄 |
upload_at | 上傳時間 |
查看用戶已上傳的應(yīng)用
請求地址
GET
http://fir.im/api/v2/app/mine
請求參數(shù)
參數(shù) | 說明 |
---|
token | 驗證用戶登錄 |
size | 可選 指定每頁最多返回數(shù)量 默認(rèn)10條 |
page | 可選 指定返回返回頁數(shù) 默認(rèn)返回第一頁 |
返回參數(shù)
返回的是一個數(shù)組, 每個元素的數(shù)據(jù)結(jié)構(gòu)如下:
參數(shù) | 說明 |
---|
count | App的數(shù)量 |
id | App在數(shù)據(jù)庫中的id |
update_at | 上次更新日期 |
appid | com.abc.def 反DNS形式 |
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
icon | App圖標(biāo)地址 |
changelog | 更新記錄 |
iconFile | |
upload_at | 上傳時間 |
devices | 設(shè)備信息 |
上傳App
詳細(xì)解釋上傳應(yīng)用流程 --> 將文件和key
,token
以form表單的格式POST到pkg.url(此例中服務(wù)器要求將文件上傳到七牛),這里是用命令行curl來上傳的方法,其他網(wǎng)頁表單類似:
curl -F file=@/some/file/on/your/local/disk -F "key=vqaOkQ2...xY4IvfyKTKORWah0esdoa7yyfsJ" -F "token=2MHm2Srw8ucAeUwTrkfXSgx35GMiSYWo5N4QCy-B:v3IzkUr...wNTU4MDczOX" http://up.qiniu.com
請求地址
GET
http://fir.im/api/v2/app/info/:appid
請求參數(shù)
參數(shù) | 說明 |
---|
appid | com.abc.def 反DNS形式 |
type | 可選 指定上傳App類型,默認(rèn)為ios (目前支持ios,android) |
token | 可選 驗證用戶是否登錄,并驗證ACL權(quán)限 |
返回參數(shù)
參數(shù) | 說明 |
---|
id | App在數(shù)據(jù)庫中的id |
appid | 可以是com.abc.def 反DNS形式 也可以是284910350 的數(shù)字形式 |
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
icon | App圖標(biāo)地址 |
teamIds | 允許內(nèi)測的團(tuán)隊 |
bundle | 上傳所需的信息 |
show | 是否在廣場中展示 |
獲取App詳情信息
請求地址
GET
http://fir.im/api/v2/app/:id
請求參數(shù)
參數(shù) | 說明 |
---|
id | App在數(shù)據(jù)庫中的唯一id |
token | 驗證用戶是否登錄,并驗證ACL權(quán)限 |
返回參數(shù)
參數(shù) | 說明 |
---|
owner | 該App在數(shù)據(jù)庫中對應(yīng)的用戶id |
acl | 對該app操作權(quán)限控制列表 |
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
icon | App圖標(biāo)地址 |
iconFile | |
upScreens | 上傳的截圖地址 |
update_at | 更新日期 |
version | App版本號 |
versionShort | |
changelog | 更新記錄 |
history | App的歷史版本以及在數(shù)據(jù)庫中對應(yīng)的App id |
screens | 抓取的App截圖 |
gener | |
type | App類型 |
desc | App描述 |
devices | |
appid | App包名 |
isInfoRefresh | 是否更新過App數(shù)據(jù) |
release_type | |
show | 是否允許在廣場中顯示 |
修改App詳情信息
請求地址
PUT
http://fir.im/api/v2/app/:id
請求參數(shù)
參數(shù) | 說明 |
---|
id | App在數(shù)據(jù)庫中生成的id |
token | 驗證用戶是否登錄,并驗證ACL權(quán)限 |
acl | 可選 修改對該app有操作權(quán)限對應(yīng)的用戶id |
short | 可選 修改短地址 3~8位數(shù)字或字符 |
name | 可選 修改App名 |
version | 可選 App版本號 |
versionShort | 可選 |
changelog | 可選 更新記錄 |
desc | 可選 App描述 |
devices | 可選 |
isInfoRefresh | 可選 是否更新過App數(shù)據(jù) |
release_type | 可選 |
show | 可選 是否允許在廣場中顯示 |
返回參數(shù)
參數(shù) | 說明 |
---|
owner | 該App在數(shù)據(jù)庫中對應(yīng)的用戶id |
acl | 對該app有操作權(quán)限對應(yīng)的用戶id |
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
icon | App圖標(biāo)地址 |
iconFile | |
upScreens | 上傳的截圖地址 |
update_at | 更新日期 |
version | App版本號 |
versionShort | |
changelog | 更新記錄 |
history | App的歷史版本以及在數(shù)據(jù)庫中對應(yīng)的App id |
screens | 抓取的App截圖 |
gener | |
type | App類型 |
desc | App描述 |
devices | |
appid | App包名 |
isInfoRefresh | 是否更新過App數(shù)據(jù) |
release_type | |
show | 是否允許在廣場中顯示 |
驗證App短鏈接
請求地址
GET
http://fir.im/api/v2/app/short/verify/:short
請求參數(shù)
參數(shù) | 說明 |
---|
short | 短地址 3~8位數(shù)字或字符 |
oid | App在數(shù)據(jù)庫中生成的id |
token | 驗證用戶是否登錄,并驗證ACL權(quán)限 |
返回參數(shù)
參數(shù) | 說明 |
---|
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
appid | com.abc.def 反DNS形式 |
安裝App
! 注意: iOS應(yīng)用只允許使用itms-services
協(xié)議訪問, 直接在瀏覽器訪問會被拒絕! Android應(yīng)用不受此限制影響.
請求地址
GET
http://fir.im/api/v2/app/install/:oid
請求參數(shù)
參數(shù) | 說明 |
---|
oid | App在數(shù)據(jù)庫中生成的id |
token | 可選 驗證用戶是否登錄,并驗證是否有下載權(quán)限 |
返回參數(shù)
瀏覽器直接跳轉(zhuǎn)下載
安裝App歷史版本
! 注意: 該接口只能使用iOS設(shè)備上的Safari瀏覽器中使用
請求地址
GET
http://fir.im/api/v2/installHistory/:oid
請求參數(shù)
參數(shù) | 說明 |
---|
oid | App在數(shù)據(jù)庫中生成的id |
fileid | 可選 歷史版本fileid (獲取App詳情后,返回結(jié)果history中file字段) |
token | 可選 驗證用戶是否登錄,并驗證是否有下載權(quán)限 |
返回參數(shù)
瀏覽器直接跳轉(zhuǎn)下載
App搜索
請求地址
GET
http://fir.im/api/v2/app/query?key=xxx
請求參數(shù)
參數(shù) | 說明 |
---|
key | 搜索App的名稱或者App的appid |
type | 可選 搜索的App類型(ios/android),默認(rèn)搜索全部類型 |
token | 可選 驗證用戶是否登錄,并驗證是否有下載權(quán)限 |
size | 可選 分頁顯示app數(shù)量,默認(rèn)為48 |
page | 可選 指定返回的頁數(shù),默認(rèn)為第一頁 |
返回參數(shù)
參數(shù) | 說明 |
---|
owner | 該App在數(shù)據(jù)庫中對應(yīng)的用戶id |
acl | 對該app操作權(quán)限控制列表 |
short | 短地址 3~8位數(shù)字或字符 |
name | App名 |
icon | App圖標(biāo)地址 |
iconFile | |
upScreens | 上傳的截圖地址 |
update_at | 更新日期 |
version | App版本號 |
versionShort | |
changelog | 更新記錄 |
history | App的歷史版本以及在數(shù)據(jù)庫中對應(yīng)的App id |
screens | 抓取的App截圖 |
gener | |
type | App類型 |
desc | App描述 |
devices | |
appid | App包名 |
isInfoRefresh | 是否更新過App數(shù)據(jù) |
release_type | |
show | 是否允許在廣場中顯示 |
本站僅提供存儲服務(wù),所有內(nèi)容均由用戶發(fā)布,如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請
點(diǎn)擊舉報。