批次調整應用程式順序

批次調整應用程式順序；僅可管理目前站點及此 Token 擁有的軟體源。

PUT/api/appstore/manage/sources/:source_id/apps/order

驗證:Bearer Token

速率限制:30/分鐘

請求參數

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

參數名	類型	必填	說明
`source_id`	string	必填	目前站點本人擁有的軟體源 ID 範例: 12345678
`app_ids`	array	必填	應用程式 ID 排序陣列（1–200 項）範例: [1,2]

回應參數

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

回應示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"app_ids":

[

]

}

錯誤碼

錯誤碼4 個定義

10

Token 無效

Token 無效或已更新；HTTP 401

11

Token 已過期

Token 已超過有效期；HTTP 401

40001

軟體源不存在

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

回應語言

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

建議請求標頭

X-Lang: zh-TW

支援的語言

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

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

程式碼示例

curl -X PUT "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/order" \
  -H "X-Lang: zh-TW" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_ids": [
      1,
      2
    ]
  }'

注意事項

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

在控制台試一試

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

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

Authorization: Bearer Token

source_idstring必填

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

app_idsarray必填

應用程式 ID 排序陣列（1–200 項）