一鍵初始化軟體源

一鍵初始化軟體源；僅可管理目前站點及此 Token 擁有的軟體源。

POST/api/appstore/manage/quick-setup

驗證:Bearer Token

速率限制:5/分鐘

請求參數

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

參數名	類型	必填	說明
`Idempotency-Key`	string	必填	16–128 位字母、數字、連字號或底線；相同請求在 24 小時內回傳相同結果範例: setup-example-00000001
`source`	object	必填	軟體源設定物件；必須包含 name 範例: {"name":"我的软件源"}
`apps`	array	選填	初始應用程式（最多 10 個）；每項均需 name 與 download_url 範例: [{"name":"演示应用","download_url":"https://example.com/app.ipa"}]

回應參數

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

回應示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"source_id":"12345678",

"source_url":"/api/rjy/12345678/appstore",

"app_ids":

[

]

}

錯誤碼

錯誤碼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 POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/quick-setup" \
  -H "X-Lang: zh-HK" \
  -H "Idempotency-Key: setup-example-00000001" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "name": "我的软件源"
    },
    "apps": [
      {
        "name": "演示应用",
        "download_url": "https://example.com/app.ipa"
      }
    ]
  }'

注意事項

請使用 HTTPS。uid、tenant_id、is_official 與到期時間等管理員欄位不被接受。
回應不包含擁有者身分、內部草稿或密鑰；建立源與應用程式受訂閱、試用及配額限制。
源、應用程式、版本與冪等回執會在同一交易中提交；失敗時不留半成品。
同一使用者及租戶以相同 Idempotency-Key 發送不同內容時，回傳 HTTP 409。

在控制台試一試

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

POSThttps://testypro.iwai.cc/api/appstore/manage/quick-setup已鎖定本站

Authorization: Bearer Token

Idempotency-Keystring必填

16–128 位字母、數字、連字號或底線；相同請求在 24 小時內回傳相同結果

sourceobject必填

軟體源設定物件；必須包含 name

appsarray

初始應用程式（最多 10 個）；每項均需 name 與 download_url