POST

v1.0.0stable

建立軟體源

建立軟體源；僅可管理目前站點及此 Token 擁有的軟體源。

POST/api/appstore/manage/sources

驗證:Bearer Token

速率限制:30/分鐘

請求參數

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

參數名	類型	必填	說明
`name`	string	必填	軟體源名稱，最多 100 字範例: 我的软件源
`message`	string	選填	軟體源公告範例: 欢迎使用
`identifier`	string	選填	源識別碼，最多 100 字
`source_icon`	string	選填	軟體源圖示的 HTTP(S) 網址
`pay_url`	string	選填	付費頁面的 HTTP(S) 網址
`encrypt_enabled`	integer	選填	回應加密：0=關、1=開（建立時預設開）範例: 1
`open_black`	integer	選填	自動封鎖新增者：0/1 範例: 0
`open_black2`	integer	選填	自動封鎖破解者：0/1 範例: 0
`health_alert`	object	選填	完整的連結健康警示設定 JSON 物件

回應參數

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

回應示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"source_id":"12345678",

"name":"我的软件源",

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

"message":"欢迎使用",

"encrypt_enabled":1,

"app_count":0

}

錯誤碼

錯誤碼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/sources" \
  -H "X-Lang: zh-HK" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "我的软件源",
    "message": "欢迎使用",
    "identifier": "example_identifier",
    "source_icon": "example_source_icon",
    "pay_url": "example_pay_url",
    "encrypt_enabled": 1,
    "open_black": 0,
    "open_black2": 0,
    "health_alert": "example_health_alert"
  }'

注意事項

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

在控制台試一試

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

POSThttps://testypro.iwai.cc/api/appstore/manage/sources已鎖定本站

Authorization: Bearer Token

namestring必填

軟體源名稱，最多 100 字

messagestring

軟體源公告

identifierstring

源識別碼，最多 100 字

source_iconstring

軟體源圖示的 HTTP(S) 網址

pay_urlstring

付費頁面的 HTTP(S) 網址

encrypt_enabledinteger

回應加密：0=關、1=開（建立時預設開）

open_blackinteger

自動封鎖新增者：0/1

open_black2integer

自動封鎖破解者：0/1

health_alertobject

完整的連結健康警示設定 JSON 物件