GET

v1.0.0stable

列出源内应用

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

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

认证:Bearer Token

限流:60/分钟

请求参数

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

参数名	类型	必填	说明
`source_id`	string	必填	本人当前站点的软件源 ID 示例: 12345678
`page`	integer	可选	页码，从 1 开始示例: 1
`page_size`	integer	可选	每页数量，软件源最多 100，应用最多 200 示例: 20

响应参数

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

响应示例

{

"code":1,

"msg":"操作成功",

"time":1780000000,

"data":

{

"list":

[

{

"id":1,

"source_id":"12345678",

"name":"演示应用",

"version":"1.0",

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

"status":1,

"publish_status":"published"

}

]

"total":1,

"page":1,

"pages":1

}

错误码

错误码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 GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps?page=1&page_size=20" \
  -H "X-Lang: zh" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

注意事项

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

在控制台试一试

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

GEThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps?page=1&page_size=20已锁定本站

Authorization: Bearer Token

source_idstring必填

本人当前站点的软件源 ID

pageinteger

页码，从 1 开始

page_sizeinteger

每页数量，软件源最多 100，应用最多 200