PATCH
v1.0.0stable快速修改軟體源設定
快速修改軟體源設定；僅可管理目前站點及此 Token 擁有的軟體源。
PATCH
/api/appstore/manage/sources/:source_id驗證:Bearer Token
速率限制:30/分鐘
請求參數
所有請求參數需透過 Query 或 Body 傳遞
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
source_id | string | 必填 | 目前站點本人擁有的軟體源 ID 範例: 12345678 |
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 個定義
10Token 無效
Token 無效或已更新；HTTP 401
11Token 已過期
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 PATCH "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678" \
-H "X-Lang: zh-TW" \
-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 與到期時間等管理員欄位不被接受。
- 回應不包含擁有者身分、內部草稿或密鑰；建立源與應用程式受訂閱、試用及配額限制。
- 只會修改傳入欄位；health_alert 會替換整個物件。
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。
PATCH
https://testypro.iwai.cc/api/appstore/manage/sources/12345678已鎖定本站string必填
目前站點本人擁有的軟體源 ID
string
軟體源名稱，最多 100 字
string
軟體源公告
string
源識別碼，最多 100 字
string
軟體源圖示的 HTTP(S) 網址
string
付費頁面的 HTTP(S) 網址
integer
回應加密：0=關、1=開（建立時預設開）
integer
自動封鎖新增者：0/1
integer
自動封鎖破解者：0/1
object
完整的連結健康警示設定 JSON 物件