PUT
v1.0.0stable

批量调整应用顺序

批量调整应用顺序;仅可操作当前站点、当前 Token 所属用户的软件源。

PUT/api/appstore/manage/sources/:source_id/apps/order
认证:Bearer Token
限流:30/分钟

请求参数

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

参数名类型必填说明
source_id
string必填
本人当前站点的软件源 ID
示例: 12345678
app_ids
array必填
目标应用 ID 数组(1-200 项)
示例: [1,2]

响应参数

参数名类型必填说明
code
integer必填
成功为 1;失败为 Token、参数或软件源业务错误码
示例: 1
msg
string必填
结果提示
示例: 获取成功
time
integer必填
服务器 Unix 秒时间戳
data
object必填
仅包含可公开给源所有者的安全字段
响应示例
{
"code":1,
"msg":"操作成功",
"time":1780000000,
"data":
{
"app_ids":
[
1,
2
]
}
}

错误码

错误码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 PUT "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/appstore/manage/sources/12345678/apps/order" \
  -H "X-Lang: zh" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_ids": [
      1,
      2
    ]
  }'

注意事项

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

在控制台试一试

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

PUThttps://testypro.iwai.cc/api/appstore/manage/sources/12345678/apps/order已锁定本站
string必填

本人当前站点的软件源 ID

array必填

目标应用 ID 数组(1-200 项)