POST

v1.0.0stable

添加软件源应用

添加软件源应用；仅可操作当前站点、当前 Token 所属用户的软件源。

POST/api/appstore/manage/sources/:source_id/apps

认证:Bearer Token

限流:30/分钟

请求参数

所有请求参数需通过 Query 或 Body 传递

参数名	类型	必填	说明
`source_id`	string	必填	本人当前站点的软件源 ID 示例: 12345678
`name`	string	必填	应用名称，最长 100 字示例: 演示应用
`download_url`	string	必填	应用下载的 HTTP(S) 地址示例: https://example.com/app.ipa
`version`	string	可选	版本号示例: 1.0
`type`	string	可选	软件类型
`version_desc`	string	可选	版本更新说明
`icon_url`	string	可选	应用图标 HTTP(S) 地址
`tint_color`	string	可选	主题色
`size`	string	可选	文件大小
`is_lanzou`	integer	可选	蓝奏云：0/1
`is_locked`	integer	可选	需要卡密解锁：0/1
`ios_version_limit`	string	可选	iOS 版本限制
`weigh`	integer	可选	排序权重

响应参数

参数名	类型	必填	说明
`code`	integer	必填	成功为 1；失败为 Token、参数或软件源业务错误码示例: 1
`msg`	string	必填	结果提示示例: 获取成功
`time`	integer	必填	服务器 Unix 秒时间戳
`data`	object	必填	仅包含可公开给源所有者的安全字段

响应示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"id":1,

"source_id":"12345678",

"name":"演示应用",

"version":"1.0",

"download_url":"https://example.com/app.ipa",

"status":1,

"publish_status":"published"

}

错误码

错误码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/12345678/apps" \
  -H "X-Lang: zh" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "演示应用",
    "download_url": "https://example.com/app.ipa",
    "version": "1.0",
    "type": "example_type",
    "version_desc": "example_version_desc",
    "icon_url": "example_icon_url",
    "tint_color": "example_tint_color",
    "size": "example_size",
    "is_lanzou": 1,
    "is_locked": 1,
    "ios_version_limit": "example_ios_version_limit",
    "weigh": 1
  }'

注意事项

必须使用 HTTPS 传输。接口不接受 uid、tenant_id、is_official、到期时间等管理员字段。
响应不包含拥有者身份、内部草稿或敏感密钥；创建源和应用受订阅、试用及数量限制。

在控制台试一试

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

POSThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps已锁定本站

Authorization: Bearer Token

source_idstring必填

本人当前站点的软件源 ID

namestring必填

应用名称，最长 100 字

download_urlstring必填

应用下载的 HTTP(S) 地址

versionstring

版本号

typestring

软件类型

version_descstring

版本更新说明

icon_urlstring

应用图标 HTTP(S) 地址

tint_colorstring

主题色

sizestring

文件大小

is_lanzouinteger

蓝奏云：0/1

is_lockedinteger

需要卡密解锁：0/1

ios_version_limitstring

iOS 版本限制

weighinteger

排序权重