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 示例: 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 已过期
令牌超过设置的有效期，HTTP 401
40001软件源不存在
源不存在或不属于该用户/租户，HTTP 404
响应语言
通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。
推荐请求头
X-Lang: zh支持的语言
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" \
-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 作为完整对象整体替换。
在控制台试一试
填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态
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 开启；创建时默认 1
integer
自动拉黑添加者：0/1
integer
自动拉黑破解者：0/1
object
完整的链接健康告警配置 JSON 对象