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 示例: 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 已过期

令牌超过设置的有效期，HTTP 401

40001

软件源不存在

源不存在或不属于该用户/租户，HTTP 404

响应语言

通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。

推荐请求头

X-Lang: zh

支持的语言

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" \
  -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、到期时间等管理员字段。
响应不包含拥有者身份、内部草稿或敏感密钥；创建源和应用受订阅、试用及数量限制。

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

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 开启；创建时默认 1

open_blackinteger

自动拉黑添加者：0/1

open_black2integer

自动拉黑破解者：0/1

health_alertobject

完整的链接健康告警配置 JSON 对象