SwaggerHub Registry API
SwaggerHub Registry API
SwaggerHub Registry API 管理 APIs、Domains、Projects、Templates 与 Integrations，绕过 Web UI 做规范治理。
路径层级清晰，能下钻到 owner / api / version
这是 Registry 面，不是 SwaggerHub 用户管理 API
先用 token 读取 /apis、/apis/{owner}/{api} 或具体 version，再按需测试 clone、rename、comments 与 settings/default 等路径。
可用率 · 30 天窗口
关于这个 API
SwaggerHub Registry API 是规范治理面，而不是运行时 API 网关。它的重点资源是 APIs、Domains、Projects、Templates 和 Integrations，以及版本级 clone、rename、comments 等动作。 当前资源面包含 "/apis", "/apis/{owner}", "/apis/{owner}/{api}", and "/apis/{owner}/{api}/rename"，并且还能看到 "APIs", "Templates", "Domains", and "Projects" 这些分组。
对后端团队来说，这很适合批量管理 API 版本与设置、在项目流水线里 clone 或 rename 规范，或者读取或写入 comments 做审阅流程。OpenAPI 文档点名了 "TokenSecured" 这些安全方案名。
这是 Registry 面，不是 SwaggerHub 用户管理 API 资源较多，最好先从单个 owner / api 开始建模
你可以做什么
- 1批量管理 API 版本与设置
- 2在项目流水线里 clone 或 rename 规范
- 3读取或写入 comments 做审阅流程
优劣对比
优点
- 路径层级清晰，能下钻到 owner / api / version
- comments 与 batch comments 适合评审协作
- TokenSecured 鉴权简单
注意事项
- 这是 Registry 面，不是 SwaggerHub 用户管理 API
- 资源较多，最好先从单个 owner / api 开始建模
示例请求
curl https://support.smartbear.com/swaggerhub/message/<endpoint> \
-H "Authorization: Bearer $API_KEY"
# Some providers use X-Api-Key instead — verify in the docs.快速开始
先用 token 读取 /apis、/apis/{owner}/{api} 或具体 version，再按需测试 clone、rename、comments 与 settings/default 等路径。
技术细节
- 认证方式
- api_key
- 计费
- unknown
- 协议
- REST
- 响应时间
- 310 ms
- 上次巡检
- 2026/5/12 07:38:28