GET/api/v1/admin/versions/names
管理员Cookie/HTTPS/JWE,ADMIN_VERSIONS_READJSON 响应接入指南 ↗

查询可筛选的版本号

请求参数

OWNER和VIEWER可读。要求可信HTTPS、独立Cookie及真实JWE,八项公共头必填,固定admin/web/admin_web;App Bearer不能调用。GET无业务正文。

参数 类型 必填 说明
q string 否 默认空,0–14位ASCII数字和点,按版本号前缀匹配,如1.或1.10;不接受通配符
limit integer 否 默认50,范围1–100

查询全部渠道与状态下的版本号,独立于当前列表分页和其他筛选;相同版本只出现一次。

请求示例

await request('versions/names', 'GET', undefined, {q:'1.', limit:50});

后台统一请求封装提供Accept-Language、X-Client-Type=admin、X-Platform=web、X-App-Version、X-App-Build、X-Channel=admin_web、安装X-Device-Id、每次新X-Request-Id和X-Request-Timestamp。Cookie由浏览器维护,GET密文放在X-Budyoo-JWE,无业务正文。

成功响应

HTTP200、Cache-Control:no-store;外层JWE,认证解密后示例:

{"code":"SUCCESS","message":"操作成功。","data":["1.10.0","1.9.0","1.0.0"],"errors":[]}

data为不为空值的string数组,最多limit项;无匹配返回[]。各版本号为已保存的完整三段版本,不返回记录ID、说明或下载地址。按三个整数分量倒序,因此1.10.0在1.9.0前;跨渠道和构建号重复的展示版本合并。候选不是完整历史导出,需要时继续输入前缀缩小范围。

失败响应

HTTP code 条件
400 INVALID_APP_VERSION/BAD_REQUEST 前缀含非法字符、过长或limit格式/范围非法
400 INVALID_CLIENT_HEADERS 公共头不完整或不合法
400 ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST 未发送真实JWE或校验失败
401 UNAUTHORIZED 未认证、会话失效或误用App凭据
403 FORBIDDEN/ADMIN_CSRF_INVALID 权限或来源不符
426 HTTPS_REQUIRED 后台禁止明文HTTP
429 TOO_MANY_REQUESTS 入口限流
503 SERVICE_UNAVAILABLE 持久化或Redis不可用

固定code不翻译,message使用当前界面四语及英文回退;加密错误边界遵循后台安全协议。

接入说明

选择后将完整版本号传给版本列表的versionName;新建发布后刷新候选。候选仍包括只读历史,按数字倒序去重,不受当前列表分页和其他筛选影响。

创建版本成功即发布,原子替换同渠道旧目标;校验、创建、旧目标停用和管理员审计同事务,任一步失败全部回滚。曾发布构建号必须严格递增,展示版本不能倒退。所有记录只读;停用后不自动恢复旧版本,也不提供编辑、删除或再次发布入口。

状态只有PUBLISHED(当前发布)和WITHDRAWN(停用、被替换或迁移保留的未生效历史)。V18将旧DRAFT原内容及UUID保留为WITHDRAWN,publishedAt仍为null,绝不自动发布占位地址;这些从未发布的历史不占用真实发布构建号。新建成功的publishedAt必有值,version初始为0。

App继续使用升级检查的原请求和返回字段,无需改代码。下载链接的可用性、包签名和商店状态仍须管理员确认;本接口不上传安装包、不代替商店提交或安装。

2026-11-04最终381项服务器Java回归全部通过(0失败/0跳过),包含24项版本管理、筛选、App升级与迁移用例;服务器TypeScript/Vite及7项环境/归档检查通过。验证覆盖创建即发布、旧页面缺少publish=true拒绝、历史保留、并发创建、旧快照停用、发布/替换审计回滚、升级兼容及V17→V18迁移。116份MD链接和141段JSON示例检查通过。API、V18与新版网页已配套部署。候选产物的12项真实浏览器加密夹具检查覆盖立即发布/替换/停用、确认取消、重复提交保护、只读角色、409及响应丢失后完整内容核对,实际渠道写请求0;另13项四语桌面/手机、渠道预览、强更、筛选和重置检查通过。发布前备份在独立数据库恢复验证,运行库迁移后原九条记录UUID与业务内容保持,全部为WITHDRAWN/publishedAt=null且当前发布为0。超时先点击“核对发布结果”查询渠道/构建号及完整内容,核对失败保留输入,不自动重试创建。