一键初始化软件源

一键初始化软件源；仅可操作当前站点、当前 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 已过期

令牌超过设置的有效期，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/quick-setup" \
  -H "X-Lang: zh" \
  -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。

在控制台试一试

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

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

Authorization: Bearer Token

Idempotency-Keystring必填

16-128 位字母、数字、横线或下划线；相同请求在 24 小时内返回相同结果

sourceobject必填

源配置对象，至少包含 name

appsarray

初始应用数组（最多 10 个），每项至少包含 name 和 download_url