PATCH

v1.0.0stable

修改來源內應用程式

修改來源內應用程式；僅可管理目前站點及此 Token 擁有的軟體源。

PATCH/api/appstore/manage/sources/:source_id/apps/:app_id

驗證:Bearer Token

速率限制:30/分鐘

請求參數

所有請求參數需透過 Query 或 Body 傳遞

參數名	類型	必填	說明
`source_id`	string	必填	目前站點本人擁有的軟體源 ID 範例: 12345678
`app_id`	integer	必填	此軟體源內的應用程式 ID 範例: 1
`name`	string	選填	應用程式名稱，最多 100 字範例: 演示应用
`download_url`	string	選填	應用程式下載的 HTTP(S) 網址範例: https://example.com/app.ipa
`version`	string	選填	應用程式版本範例: 1.0
`type`	string	選填	應用程式類型
`version_desc`	string	選填	版本更新說明
`icon_url`	string	選填	應用程式圖示的 HTTP(S) 網址
`tint_color`	string	選填	主題色彩
`size`	string	選填	檔案大小
`is_lanzou`	integer	選填	藍奏雲連結：0/1
`is_locked`	integer	選填	需要卡密解鎖：0/1
`ios_version_limit`	string	選填	iOS 版本限制
`weigh`	integer	選填	排序權重
`status`	integer	選填	上架：0=下架、1=上架；請先發佈草稿再修改

回應參數

參數名	類型	必填	說明
`code`	integer	必填	成功為 1；失敗時為 Token、參數或軟體源錯誤碼範例: 1
`msg`	string	必填	本地化結果訊息範例: 获取成功
`time`	integer	必填	伺服器 Unix 秒時間戳
`data`	object	必填	僅包含允許源擁有者查看的欄位

回應示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"id":1,

"source_id":"12345678",

"name":"演示应用",

"version":"1.0",

"download_url":"https://example.com/app.ipa",

"status":1,

"publish_status":"published"

}

錯誤碼

錯誤碼4 個定義

10

Token 無效

Token 無效或已更新；HTTP 401

11

Token 已過期

Token 已超過有效期；HTTP 401

40001

軟體源不存在

源不存在或不屬於此使用者／租戶；HTTP 404

回應語言

透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。

建議請求標頭

X-Lang: zh-HK

支援的語言

zh, en, zh-TW, vi, ar, es, ru

也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言依站點語言設定回退。

程式碼示例

curl -X PATCH "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/1" \
  -H "X-Lang: zh-HK" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "演示应用",
    "download_url": "https://example.com/app.ipa",
    "version": "1.0",
    "type": "example_type",
    "version_desc": "example_version_desc",
    "icon_url": "example_icon_url",
    "tint_color": "example_tint_color",
    "size": "example_size",
    "is_lanzou": 1,
    "is_locked": 1,
    "ios_version_limit": "example_ios_version_limit",
    "weigh": 1,
    "status": 1
  }'

注意事項

請使用 HTTPS。uid、tenant_id、is_official 與到期時間等管理員欄位不被接受。
回應不包含擁有者身分、內部草稿或密鑰；建立源與應用程式受訂閱、試用及配額限制。

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

PATCHhttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps/1已鎖定本站

Authorization: Bearer Token

source_idstring必填

目前站點本人擁有的軟體源 ID

app_idinteger必填

此軟體源內的應用程式 ID

namestring

應用程式名稱，最多 100 字

download_urlstring

應用程式下載的 HTTP(S) 網址

versionstring

應用程式版本

typestring

應用程式類型

version_descstring

版本更新說明

icon_urlstring

應用程式圖示的 HTTP(S) 網址

tint_colorstring

主題色彩

sizestring

檔案大小

is_lanzouinteger

藍奏雲連結：0/1

is_lockedinteger

需要卡密解鎖：0/1

ios_version_limitstring

iOS 版本限制

weighinteger

排序權重

statusinteger

上架：0=下架、1=上架；請先發佈草稿再修改