UNPKG

node-cnb

Version:

node sdk for cnb open api

1,991 lines (1,989 loc) 226 kB
//#region rolldown:runtime var __create = Object.create; var __defProp = Object.defineProperty; var __getOwnPropDesc = Object.getOwnPropertyDescriptor; var __getOwnPropNames = Object.getOwnPropertyNames; var __getProtoOf = Object.getPrototypeOf; var __hasOwnProp = Object.prototype.hasOwnProperty; var __copyProps = (to, from, except, desc) => { if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) { key = keys[i]; if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, { get: ((k) => from[k]).bind(null, key), enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable }); } return to; }; var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod)); //#endregion const ky = __toESM(require("ky")); //#region src/paths.json var events_repo_get = { "tags": ["Event"], "summary": "获取仓库动态预签名地址,并返回内容。Get events pre-signed URL and return content.", "operationId": "GetEvents", "parameters": [{ "type": "string", "description": "repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "动态日期,格式为yy-mm-dd-h, eg:2025-09-11-5", "name": "date", "in": "path", "required": true }], "responses": { "200": { "description": "OK" } }, "path": "/events/{repo}/-/{date}", "method": "get" }; var groups_post = { "tags": ["Organizations"], "summary": "创建新组织。Create new organization.", "operationId": "CreateOrganization", "parameters": [{ "description": "group information", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateGroupReq" } }], "responses": { "201": { "description": "Created" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/groups", "method": "post" }; var user_get = { "tags": ["Users"], "summary": "获取指定用户的详情信息。Get detailed information for a specified user.", "operationId": "GetUserInfo", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UsersResultForSelf" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "path": "/user", "method": "get" }; var user_post = { "tags": ["Users"], "summary": "更新指定用户的详情信息。Updates the specified user's profile information.", "operationId": "UpdateUserInfo", "parameters": [{ "description": "user info", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateUserInfoPayload" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:rw", "path": "/user", "method": "post" }; var user_autocompleteSource_list = { "tags": ["Users"], "summary": "查询当前用户用户拥有指定权限的所有资源列表。List resources that the current user has specified permissions for.", "operationId": "AutoCompleteSource", "parameters": [ { "enum": ["Group", "Repo"], "type": "string", "default": "Group", "description": "Source type", "name": "source_type", "in": "query" }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "string", "default": "", "description": "Filter by resources.", "name": "search", "in": "query" }, { "enum": [ "Reporter", "Developer", "Master", "Owner" ], "type": "string", "default": "Owner", "description": "最小仓库权限,默认owner。Minima repository permissions", "name": "access", "in": "query" }, { "enum": ["created_at", "slug_path"], "type": "string", "default": "created_at", "description": "Order field", "name": "order_by", "in": "query" }, { "type": "boolean", "default": false, "description": "排序顺序。Ordering.", "name": "desc", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "string" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/user/autocomplete_source", "method": "get" }; var user_gpgKeys_get = { "tags": ["Users"], "summary": "获取用户 GPG keys 列表。List GPG Keys.", "operationId": "ListGPGKeys", "parameters": [ { "type": "integer", "default": 1, "description": "pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "pagination page size", "name": "page_size", "in": "query" }, { "type": "string", "description": "gpg search key", "name": "keyword", "in": "query" } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/api.GPGPublicKey" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/die.WebError" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/die.WebError" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "path": "/user/gpg-keys", "method": "get" }; var user_groups_list = { "tags": ["Organizations"], "summary": "获取当前用户拥有权限的顶层组织列表。Get top-level organizations list that the current user has access to.", "operationId": "ListTopGroups", "parameters": [ { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "string", "default": "", "description": "Filter by organizations.", "name": "search", "in": "query" }, { "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "type": "string", "description": "Filter by role.", "name": "role", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.OrganizationAccess" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/user/groups", "method": "get" }; var user_groups_listByGroup = { "tags": ["Organizations"], "summary": "查询当前用户在指定组织下拥有指定权限的子组织列表。Get the list of sub-organizations that the current user has access to in the specified organization.", "operationId": "ListGroups", "parameters": [ { "type": "string", "description": "Group slug", "name": "slug", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "integer", "description": "access level", "name": "access", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.OrganizationAccess" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/user/groups/{slug}", "method": "get" }; var user_repos_list = { "tags": ["Repositories"], "summary": "获取当前用户拥有指定权限及其以上权限的仓库。List repositories owned by the current user with the specified permissions or higher.", "operationId": "GetRepos", "parameters": [ { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "string", "default": "", "description": "Filter by repositories", "name": "search", "in": "query" }, { "enum": [ "private", "public", "secret" ], "type": "string", "description": "RType", "name": "filter_type", "in": "query" }, { "enum": [ "Reporter", "Developer", "Master", "Owner" ], "type": "string", "default": "Owner", "description": "最小仓库权限,默认owner。Minima repository permissions", "name": "role", "in": "query" }, { "enum": ["KnowledgeBase"], "type": "string", "description": "仓库类型标记,逗号分隔。Repository type flags, comma separated", "name": "flags", "in": "query" }, { "enum": ["active", "archived"], "type": "string", "description": "仓库状态。Repository status", "name": "status", "in": "query" }, { "enum": [ "created_at", "last_updated_at", "stars", "slug_path", "forks" ], "type": "string", "default": "last_updated_at", "description": "Order field", "name": "order_by", "in": "query" }, { "type": "boolean", "default": false, "description": "排序顺序。Ordering.", "name": "desc", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.Repos4User" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/user/repos", "method": "get" }; var user_staredRepos_list = { "tags": ["Starring"], "summary": "获取当前用户 star 的仓库列表。List all stared repositories.", "operationId": "GetUserAllStaredRepos", "parameters": [ { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "string", "default": "", "description": "Filter by repositories", "name": "search", "in": "query" }, { "type": "boolean", "default": false, "description": "排序顺序。Ordering.", "name": "desc", "in": "query" }, { "enum": [ "created_at", "last_updated_at", "stared_time", "stars", "forks" ], "type": "string", "default": "last_updated_at", "description": "Order field", "name": "order_by", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.Repos4User" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/user/stared-repos", "method": "get" }; var users_get = { "tags": ["Users"], "summary": "获取指定用户的详情信息。Get detailed information for a specified user.", "operationId": "GetUserInfoByName", "parameters": [{ "type": "string", "description": "User Name", "name": "username", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UsersResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "path": "/users/{username}", "method": "get" }; var users_activities_get = { "tags": ["Activities"], "summary": "获取个人动态活跃详情汇总。Get user activities by date.", "operationId": "GetUserActivitiesByDate", "parameters": [{ "type": "string", "description": "UserName", "name": "username", "in": "path", "required": true }, { "type": "string", "description": "查询日期,格式 yyyyMM,或者 yyyyMMdd", "name": "date", "in": "query" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.ActivityDate" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/activities", "method": "get" }; var users_followers_list = { "tags": ["Followers"], "summary": "获取指定用户的粉丝列表。Get the followers list of specified user.", "operationId": "GetFollowersByUserID", "parameters": [ { "type": "string", "description": "Username", "name": "username", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.UserFollowResult" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/followers", "method": "get" }; var users_following_list = { "tags": ["Followers"], "summary": "获取指定用户的关注人列表。Get the list of users that the specified user is following.", "operationId": "GetFollowingByUserID", "parameters": [ { "type": "string", "description": "Username", "name": "username", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.UserFollowResult" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/following", "method": "get" }; var users_groups_get = { "tags": ["Organizations"], "summary": "获取指定用户拥有权限的顶层组织列表。 Get a list of top-level organizations that the specified user has permissions to access.", "operationId": "GetGroupsByUserID", "parameters": [ { "type": "string", "description": "UserName", "name": "username", "in": "path", "required": true }, { "type": "string", "default": "", "description": "Filter organizations.", "name": "search", "in": "query" }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.OrganizationUnion" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/groups", "method": "get" }; var users_pinnedRepos_list = { "tags": ["Repositories"], "summary": "获取指定用户的用户仓库墙。 Get a list of repositories that the specified user has pinned.", "operationId": "GetPinnedRepoByID", "parameters": [{ "type": "string", "description": "User Name", "name": "username", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.Repos4User" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/pinned-repos", "method": "get" }; var users_repoActivities_list = { "tags": ["Activities"], "summary": "个人仓库动态详情列表。List of personal repository activity details.", "operationId": "GetUserRepoActivityDetails", "parameters": [ { "type": "string", "description": "UserName", "name": "username", "in": "path", "required": true }, { "enum": [ "issue", "pull_request", "code_review" ], "type": "string", "description": "activity type", "name": "activityType", "in": "path", "required": true }, { "type": "string", "description": "仓库路径", "name": "slug", "in": "query", "required": true }, { "type": "string", "description": "查询日期,格式 yyyyMM,或者 yyyyMMdd", "name": "date", "in": "query", "required": true } ], "responses": { "200": { "description": "返回 []dto.ActivityPullRequestDetail|[]dto.ActivityIssueDetail", "schema": { "type": "array", "items": {} } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/repo-activities/{activityType}", "method": "get" }; var users_repos_list = { "tags": ["Repositories"], "summary": "获取指定用户有指定以上权限并且客人态可见的仓库。List repositories where the specified user has the specified permission level or higher and are visible to guests.", "operationId": "GetReposByUserName", "parameters": [ { "type": "string", "description": "UserName", "name": "username", "in": "path", "required": true }, { "type": "string", "default": "", "description": "Filter by repositories", "name": "search", "in": "query" }, { "enum": [ "private", "public", "secret" ], "type": "string", "description": "Repositories type", "name": "filter_type", "in": "query" }, { "enum": ["KnowledgeBase"], "type": "string", "description": "仓库类型标记,逗号分隔。Repository type flags, comma separated", "name": "flags", "in": "query" }, { "enum": ["active", "archived"], "type": "string", "description": "仓库状态。Repository status", "name": "status", "in": "query" }, { "enum": [ "Reporter", "Developer", "Master", "Owner" ], "type": "string", "default": "Owner", "description": "最小仓库权限,默认owner。Minima repository permissions.", "name": "role", "in": "query" }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "boolean", "default": false, "description": "排序顺序。Ordering.", "name": "desc", "in": "query" }, { "enum": [ "created_at", "last_updated_at", "stars", "slug_path", "forks" ], "type": "string", "default": "last_updated_at", "description": "Order field", "name": "order_by", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.Repos4User" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/repos", "method": "get" }; var users_staredRepos_list = { "tags": ["Starring"], "summary": "获取指定用户的 star 仓库列表。Get the list of repositories starred by the specified user.", "operationId": "GetUserStaredRepos", "parameters": [ { "type": "string", "description": "UserName", "name": "username", "in": "path", "required": true }, { "type": "string", "default": "", "description": "过滤仓库。Filter by repositories", "name": "search", "in": "query" }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "type": "boolean", "default": false, "description": "Ordering", "name": "desc", "in": "query" }, { "enum": [ "created_at", "last_updated_at", "stars", "forks" ], "type": "string", "default": "last_updated_at", "description": "Order field", "name": "order_by", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.Repos4User" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/users/{username}/stared-repos", "method": "get" }; var workspace_delete_post = { "tags": ["Workspace"], "summary": "删除我的云原生开发环境。Delete my workspace.", "operationId": "DeleteWorkspace", "parameters": [{ "description": "params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.WorkspaceDeleteReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.WorkspaceDeleteResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:rw", "path": "/workspace/delete", "method": "post" }; var workspace_list_get = { "tags": ["Workspace"], "summary": "获取我的云原生开发环境列表。List my workspaces.", "operationId": "ListWorkspaces", "parameters": [ { "type": "string", "description": "Git branch name, e.g. \"main\"", "name": "branch", "in": "query" }, { "type": "string", "description": "查询结束时间。Query end time. format YYYY-MM-DD HH:mm:ssZZ, e.g. 2024-12-01 00:00:00+0800", "name": "end", "in": "query" }, { "type": "integer", "description": "Pagination page number, default(1)", "name": "page", "in": "query" }, { "type": "integer", "description": "Pagination page size, default(20), max(100)", "name": "pageSize", "in": "query" }, { "type": "string", "description": "Repository path, e.g. \"groupname/reponame\"", "name": "slug", "in": "query" }, { "type": "string", "description": "查询开始时间。Query start time. format YYYY-MM-DD HH:mm:ssZZ, e.g. 2024-12-01 00:00:00+0800", "name": "start", "in": "query" }, { "type": "string", "description": "开发环境状态,running: 开发环境已启动,closed:开发环境已关闭。Workspace status: \"running\" for started, \"closed\" for stopped.", "name": "status", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.WorkspaceListResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "path": "/workspace/list", "method": "get" }; var workspace_stop_post = { "tags": ["Workspace"], "summary": "停止/关闭我的云原生开发环境。Stop/close my workspace.", "operationId": "WorkspaceStop", "parameters": [{ "description": "params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.WorkspaceStopReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.WorkspaceStopResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:rw", "path": "/workspace/stop", "method": "post" }; var group_get = { "tags": ["Organizations"], "summary": "获取指定组织信息。Get information for the specified organization.", "operationId": "GetGroup", "parameters": [{ "type": "string", "description": "group path", "name": "group", "in": "path", "required": true }], "responses": { "200": { "description": "group", "schema": { "$ref": "#/definitions/dto.OrganizationAccess" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:r", "path": "/{group}", "method": "get" }; var group_put = { "tags": ["Organizations"], "summary": "更新组织信息, 可更新的内容为: 组织描述, 组织展示名称, 组织网站, 组织联系邮箱。Updates organization information including: description, display name, website URL and contact email.", "operationId": "UpdateOrganization", "parameters": [{ "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "description": "group information to update", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateGroupReq" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}", "method": "put" }; var group_delete = { "tags": ["Organizations"], "summary": "删除指定组织。Delete the specified organization.", "operationId": "DeleteOrganization", "parameters": [{ "type": "string", "description": "group path", "name": "group", "in": "path", "required": true }, { "type": "string", "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "name": "x-cnb-identity-ticket", "in": "header" }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-delete:rw", "path": "/{group}", "method": "delete" }; var group_inheritMembers_list = { "tags": ["Members"], "summary": "获取指定组织的继承成员。List inherited members within specified organization", "operationId": "ListInheritMembersOfGroup", "parameters": [ { "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "string", "default": "", "description": "过滤成员。Filter by member", "name": "search", "in": "query" }, { "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "type": "string", "description": "Role", "name": "role", "in": "query" }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.ListInheritMembers" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "path": "/{group}/-/inherit-members", "method": "get" }; var group_members_list = { "tags": ["Members"], "summary": "获取指定组织内的所有直接成员。List all direct members within specified organization.", "operationId": "ListMembersOfGroup", "parameters": [ { "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "Pagination page number", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "Pagination page size", "name": "page_size", "in": "query" }, { "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "type": "string", "description": "Role", "name": "role", "in": "query" }, { "type": "string", "default": "", "description": "过滤成员。Filter by member.", "name": "search", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.UsersWithAccessLevelInSlug" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "path": "/{group}/-/members", "method": "get" }; var group_members_accessLevel_get = { "tags": ["Members"], "summary": "获取指定组织内, 访问成员在当前层级内的权限信息。Get permission information for accessing members at current level.", "operationId": "GetMemberAccessLevelOfGroup", "parameters": [{ "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "boolean", "default": true, "description": "是否包含继承的权限。If inherited permissions are included.", "name": "include_inherit", "in": "query" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.MemberAccessLevelInSlugUnion" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "path": "/{group}/-/members/access-level", "method": "get" }; var group_members_put = { "tags": ["Members"], "summary": "更新指定组织的直接成员权限信息。Update permission information for direct members in specified organization.", "operationId": "UpdateMembersOfGroup", "parameters": [ { "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }, { "description": "member information", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}/-/members/{username}", "method": "put" }; var group_members_post = { "tags": ["Members"], "summary": "添加成员。Add members.", "operationId": "AddMembersOfGroup", "parameters": [ { "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }, { "description": "member information", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}/-/members/{username}", "method": "post" }; var group_members_delete = { "tags": ["Members"], "summary": "删除指定组织的直接成员。Remove direct members from specified organization.", "operationId": "DeleteMembersOfGroup", "parameters": [{ "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}/-/members/{username}", "method": "delete" }; var group_members_accessLevel_list = { "tags": ["Members"], "summary": "获取指定组织内指定成员的权限信息, 结果按组织层级来展示, 包含上层组织的权限继承信息。Get specified member's permissions with organizational hierarchy.", "operationId": "ListMemberAccessLevelOfGroup", "parameters": [{ "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.MemberAccessLevel" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "path": "/{group}/-/members/{username}/access-level", "method": "get" }; var group_transfer_post = { "tags": ["Organizations"], "summary": "转移组织。Transfer an organization.", "operationId": "TransferGroup", "parameters": [{ "type": "string", "description": "slug", "name": "group", "in": "path", "required": true }, { "description": "request", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.TransferSlugReq" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}/-/transfer", "method": "post" }; var group_upload_logos_post = { "tags": ["Organizations"], "summary": "发起一个上传 logo 的请求,返回上传文件的url,请使用 put 发起流式上传。Initiate a request to upload logo,returns upload URL.Use PUT to initiate a stream upload.", "operationId": "UploadLogos", "parameters": [{ "type": "string", "description": "group", "name": "group", "in": "path", "required": true }, { "description": "UploadRequestParams", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UploadRequestParams" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UploadAssetsResponse" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "path": "/{group}/-/upload/logos", "method": "post" }; var mission_delete = { "tags": ["Missions"], "summary": "删除指定任务集。Delete the specified mission.", "operationId": "DeleteMission", "parameters": [{ "type": "string", "description": "mission path", "name": "mission", "in": "path", "required": true }, { "type": "string", "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "name": "x-cnb-identity-ticket", "in": "header" }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-delete:rw", "path": "/{mission}", "method": "delete" }; var mission_members_post = { "tags": ["Members"], "summary": "添加成员。Add members.", "operationId": "AddMembersOfMission", "parameters": [ { "type": "string", "description": "slug", "name": "mission", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }, { "description": "member information", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "path": "/{mission}/-/members/{username}", "method": "post" }; var mission_mission_view_get = { "tags": ["Missions"], "summary": "查询任务集视图配置信息。Get mission view config.", "operationId": "GetMissionViewConfig", "parameters": [{ "type": "string", "description": "Mission slug", "name": "mission", "in": "path", "required": true }, { "type": "string", "description": "View ID", "name": "id", "in": "query", "required": true }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.MissionViewConfig" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:r", "path": "/{mission}/-/mission/view", "method": "get" }; var mission_mission_view_post = { "tags": ["Missions"], "summary": "设置任务集视图配置信息。Set mission view config.", "operationId": "PostMissionViewConfig", "parameters": [{ "type": "string", "description": "Mission slug", "name": "mission", "in": "path", "required": true }, { "description": "Params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.MissionViewConfig" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "path": "/{mission}/-/mission/view", "method": "post" }; var mission_mission_viewList_list = { "tags": ["Missions"], "summary": "获取任务集视图列表。Get view list of a mission.", "operationId": "GetMissionViewList", "parameters": [{ "type": "string", "description": "mission", "name": "mission", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.MissionView" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:r", "path": "/{mission}/-/mission/view-list", "method": "get" }; var mission_mission_viewList_put = { "tags": ["Missions"], "summary": "添加、修改任务集视图。Update a mission view or add a new one.", "operationId": "PutMissionViewList", "parameters": [{ "type": "string", "description": "Mission slug", "name": "mission", "in": "path", "required": true }, { "description": "Params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.MissionView" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "path": "/{mission}/-/mission/view-list", "method": "put" }; var mission_mission_viewList_post = { "tags": ["Missions"], "summary": "排序任务集视图。Sort mission view list.", "operationId": "PostMissionViewList", "parameters": [{ "type": "string", "description": "Mission slug", "name": "mission", "in": "path", "required": true }, { "description": "Params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.MissionPostViewReq" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "path": "/{mission}/-/mission/view-list", "method": "post" }; var mission_settings_setVisibility_post = { "tags": ["Missions"], "summary": "改变任务集可见性。Update the visibility of a mission.", "operationId": "SetMissionVisibility", "parameters": [{ "type": "string", "description": "mission path", "name": "mission", "in": "path", "required": true }, { "enum": ["Private", "Public"], "type": "string", "description": "任务集可见性", "name": "visibility", "in": "query", "required": true }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "path": "/{mission}/-/settings/set_visibility", "method": "post" }; var registry_delete = { "tags": ["Registries"], "summary": "删除制品库。Delete the registry.", "operationId": "DeleteRegistry", "parameters": [{ "type": "string", "description": "制品库路径。Registry path.", "name": "registry", "in": "path", "required": true }, { "type": "string", "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "name": "x-cnb-identity-ticket", "in": "header" }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nregistry-delete:rw", "path": "/{registry}", "method": "delete" }; var registry_members_post = { "tags": ["Members"], "summary": "添加成员。Add members.", "operationId": "AddMembersOfRegistry", "parameters": [ { "type": "string", "description": "slug", "name": "registry", "in": "path", "required": true }, { "type": "string", "description": "username", "name": "username", "in": "path", "required": true }, { "description": "member information", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nregistry-manage:rw", "path": "/{registry}/-/members/{username}", "method": "post" }; var registry_settings_setVisibility_post = { "tags": ["Registries"], "summary": "改变制品仓库可见性。Update visibility of registry.", "operationId": "SetRegistryVisibility", "parameters": [{ "type": "string", "description": "制品库路径。Registry path.", "name": "registry", "in": "path", "required": true }, { "enum": ["Private", "Public"], "type": "string", "description": "可见性。Visibility", "name": "visibility", "in": "query", "required": true }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nregistry-manage:rw", "path": "/{registry}/-/settings/set_visibility", "method": "post" }; var repo_get = { "tags": ["Repositories"], "summary": "获取指定仓库信息。Get information for the specified repository.", "operationId": "GetByID", "parameters": [{ "type": "string", "description": "repo path", "name": "repo", "in": "path", "required": true }], "responses": { "200": { "description": "repo", "schema": { "$ref": "#/definitions/dto.Repos4User" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-basic-info:r", "path": "/{repo}", "method": "get" }; var repo_delete = { "tags": ["Repositories"], "summary": "删除指定仓库。Delete the specified repository.", "operationId": "DeleteRepo", "parameters": [{ "type": "string", "description": "repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "name": "x-cnb-identity-ticket", "in": "header" }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-delete:rw", "path": "/{repo}", "method": "delete" }; var repo_patch = { "tags": ["Repositories"], "summary": "更新仓库信息, 可更新的内容为: 仓库简介, 仓库站点, 仓库主题, 开源许可证。updates repository details including description, website URL,topics and license type.", "operationId": "UpdateRepo", "parameters": [{ "type": "string", "description": "repo path", "name": "repo", "in": "path", "required": true }, { "description": "request body", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.RepoPatch" } }], "responses": { "200": { "description": "OK" } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-manage:rw", "path": "/{repo}", "method": "patch" }; var repo_ai_chat_completions_post = { "tags": ["AI"], "summary": "AI 对话。调用者需有代码写权限(CI 中使用 CNB_TOKEN 不检查写权限)。AI chat completions. Requires caller to have repo write permission (except when using CNB_TOKEN in CI).", "operationId": "AiChatCompletions", "parameters": [{ "type": "string", "description": "仓库完整路径", "name": "repo", "in": "path", "required": true }, { "description": "AI chat completions params. The params may differ by model.", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AiChatCompletionsReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.AiChatCompletionsResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-code:r", "path": "/{repo}/-/ai/chat/completions", "method": "post" }; var repo_badge_git_get = { "tags": ["Badge"], "summary": "获取徽章 svg 或 JSON 数据。Get badge svg or JSON data.", "operationId": "GetBadge", "parameters": [ { "type": "string", "description": "仓库完整路径", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "latest 或 commit 8 位短 hash(例如 89d48c07)", "name": "sha", "in": "path", "required": true }, { "type": "string", "description": "徽章名,例如 pr 事件徽章名为:ci/status/pull_request, 如需获取 JSON 数据,可加上 .json 后缀,如:ci/status/pull_request.json", "name": "badge", "in": "path", "required": true }, { "description": "GetBadge params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.GetBadgeReq" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.GetBadgeResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-commit-status:r", "path": "/{repo}/-/badge/git/{sha}/{badge}", "method": "get" }; var repo_badge_list_get = { "tags": ["Badge"], "summary": "获取徽章列表数据。List badge data", "operationId": "ListBadge", "parameters": [{ "type": "string", "description": "仓库完整路径", "name": "repo", "in": "path", "required": true }, { "description": "ListBadge params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.ListBadgeReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.ListBadgeResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-commit-status:r", "path": "/{repo}/-/badge/list", "method": "get" }; var repo_badge_upload_post = { "tags": ["Badge"], "summary": "上传徽章数据。Upload badge data", "operationId": "UploadBadge", "parameters": [{ "type": "string", "description": "仓库完整路径", "name": "repo", "in": "path", "required": true }, { "description": "UploadBadge params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UploadBadgeReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UploadBadgeResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-commit-status:rw", "path": "/{repo}/-/badge/upload", "method": "post" }; var repo_build_ai_autoPr_post = { "tags": ["AI"], "summary": "根据传入的需求内容和需求标题借助 AI 自动编码并提 PR。Automatically code and create a PR with AI based on the input requirement content and title.", "operationId": "AiAutoPr", "parameters": [{ "type": "string", "description": "仓库完整路径", "name": "repo", "in": "path", "required": true }, { "description": "AI auto PR params", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AiAutoPrReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.AiAutoPrResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-code:rw", "path": "/{repo}/-/build/ai/auto-pr", "method": "post" }; var repo_build_crontab_sync_post = { "tags": ["Build"], "summary": "同步仓库分支下的定时任务。 Synchronize the content under the repository branch.", "operationId": "BuildCrontabSync", "parameters": [{ "type": "string", "description": "repo", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "Branch", "name": "branch", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildCommonResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:rw", "path": "/{repo}/-/build/crontab/sync/{branch}", "method": "post" }; var repo_build_logs_get = { "tags": ["Build"], "summary": "查询流水线构建列表。List pipeline builds.", "operationId": "GetBuildLogs", "parameters": [ { "type": "string", "description": "Repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "Start date in \"YYYY-MM-DD\" format, e.g. \"2024-12-01\"", "name": "createTime", "in": "query" }, { "type": "string", "description": "End date in \"YYYY-MM-DD\" format, e.g. \"2024-12-01\"", "name": "endTime", "in": "query" }, { "type": "string", "description": "Event name, e.g. \"push\"", "name": "event", "in": "query" }, { "type": "integer", "description": "Pagination page number, default(1)", "name": "page", "in": "query" }, { "type": "integer", "description": "Pagination page size, default(30), max(100)", "name": "pagesize", "in": "query" }, { "type": "string", "description": "Commit ID, e.g. \"2221d4535ec0c921bcd0858627c5025a871dd2b5\"", "name": "sha", "in": "query" }, { "type": "string", "description": "Build SN, e.g. \"cnb-1qa-1i3f5ecau", "name": "sn", "in": "query" }, { "type": "string", "description": "Source branch name, e.g. \"dev\"", "name": "sourceRef", "in": "query" }, { "type": "string", "description": "Build status: \"pending\", \"success\", \"error\", \"cancel\"", "name": "status", "in": "query" }, { "type": "string", "description": "Target branch name, e.g. \"main\"", "name": "targetRef", "in": "query" }, { "type": "string", "description": "User ID", "name": "userId", "in": "query" }, { "type": "string", "description": "Username", "name": "userName", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildLogsResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:r", "path": "/{repo}/-/build/logs", "method": "get" }; var repo_build_logs_stage_get = { "tags": ["Build"], "summary": "查询流水线Stage详情。Get pipeline build stage detail.", "operationId": "GetBuildStage", "parameters": [ { "type": "string", "description": "Repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "SN", "name": "sn", "in": "path", "required": true }, { "type": "string", "description": "PipelineId", "name": "pipelineId", "in": "path", "required": true }, { "type": "string", "description": "stageId", "name": "stageId", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildStageResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:r", "path": "/{repo}/-/build/logs/stage/{sn}/{pipelineId}/{stageId}", "method": "get" }; var repo_build_logs_delete = { "tags": ["Build"], "summary": "删除流水线日志内容。Delete pipeline logs content.", "operationId": "BuildLogsDelete", "parameters": [{ "type": "string", "description": "Repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "Sn", "name": "sn", "in": "path", "required": true }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildCommonResult" } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:rw", "path": "/{repo}/-/build/logs/{sn}", "method": "delete" }; var repo_build_runner_download_log_get = { "tags": ["Build"], "summary": "流水线runner日志下载。Pipeline runner log download.", "operationId": "BuildRunnerDownloadLog", "parameters": [{ "type": "string", "description": "Repo path", "name": "repo", "in": "path", "required": true }, { "type": "string", "description": "PipelineId", "name": "pipelineId", "in": "path", "required": true }