Open API

287 字小于 1 分钟

Open API 是 CNB 平台对外开放的 HTTP 接口，覆盖代码托管、组织成员、流水线、制品库等能力，供第三方系统集成或脚本调用。

使用场景：想让外部系统读写 CNB 资源时使用——例如自建平台同步仓库与成员信息、用脚本批量创建 Issue、把构建结果回写到业务系统。平台同时提供 CNB CLI 与 Skills 在命令行或 AI 助手中调用这些接口。

API 服务地址

API 服务与文档地址为 https://api.cnb.build。

API 文档地址

OpenAPI 文档页面：https://api.cnb.build（在新窗口打开）
Swagger JSON：https://api.cnb.build/swagger.json（在新窗口打开）

调用方式

Header 信息

Authorization：身份验证，格式为 Bearer ${token}，其中 ${token} 为访问令牌。
Accept：按 API 文档中 Response content type 列举的可选类型填写，如 application/json。

请求示例

curl 请求示例：

curl  -X "GET" \
      -H "accept: application/json" \
      -H "Authorization: Bearer 1Z00000000000000000000000vA" \
  "https://api.cnb.build/user/groups?page=1&page_size=10"

仓库动态相关接口，请参见仓库动态。