PUT
v1.0.0stable批次調整應用程式順序
批次調整應用程式順序;僅可管理目前站點及此 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":
[]
1,
2
錯誤碼
錯誤碼4 個定義
10Token 無效
Token 無效或已更新;HTTP 401
11Token 已過期
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 PUT "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/order" \
-H "X-Lang: zh-HK" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"app_ids": [
1,
2
]
}'注意事項
- 請使用 HTTPS。uid、tenant_id、is_official 與到期時間等管理員欄位不被接受。
- 回應不包含擁有者身分、內部草稿或密鑰;建立源與應用程式受訂閱、試用及配額限制。
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API,地址已鎖定不可修改;會攜帶你當前登入的 Cookie。
PUT
https://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps/order已鎖定本站string必填
目前站點本人擁有的軟體源 ID
array必填
應用程式 ID 排序陣列(1–200 項)