UNPKG

node-cnb

Version:

node sdk for cnb open api

2,008 lines (2,006 loc) 199 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 axios = __toESM(require("axios")); //#region src/paths.json var groups_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "CreateOrganization", "tags": ["Organizations"], "summary": "创建新组织。Create new organization.", "parameters": [{ "description": "group information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.CreateGroupReq" } }], "responses": { "201": { "description": "Created" } }, "path": "/groups", "method": "post" }; var user_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "operationId": "GetUserInfo", "tags": ["Users"], "summary": "获取指定用户的详情信息。Get detailed information for a specified user.", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UsersResultForSelf" } } }, "path": "/user", "method": "get" }; var user_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:rw", "operationId": "UpdateUserInfo", "tags": ["Users"], "summary": "更新指定用户的详情信息。Updates the specified user's profile information.", "parameters": [{ "description": "user info", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/http.UpdateUserInfoPayload" } }], "responses": { "200": { "description": "OK" } }, "path": "/user", "method": "post" }; var user_autocompleteSource_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "AutoCompleteSource", "tags": ["Users"], "summary": "查询当前用户用户拥有指定权限的所有资源列表。List resources that the current user has specified permissions for.", "parameters": [ { "default": "group", "description": "Source type, default(group)", "enum": ["Group", "Repo"], "in": "query", "name": "source_type", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": "", "description": "Filter by resources.", "in": "query", "name": "search", "type": "string" }, { "default": "owner", "description": "最小仓库权限,默认owner。Minima repository permissions, default(owner)", "enum": [ "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "access", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "type": "string" }, "type": "array" } } }, "path": "/user/autocomplete_source", "method": "get" }; var user_groups_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "ListTopGroups", "tags": ["Organizations"], "summary": "获取当前用户拥有权限的顶层组织列表。Get top-level organizations list that the current user has access to.", "parameters": [ { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": "", "description": "Filter by organizations.", "in": "query", "name": "search", "type": "string" }, { "description": "Filter by role.", "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "role", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.OrganizationAccess" }, "type": "array" } } }, "path": "/user/groups", "method": "get" }; var user_groups_listByGroup = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "ListGroups", "tags": ["Organizations"], "summary": "查询当前用户在指定组织下拥有指定权限的子组织列表。Get the list of sub-organizations that the current user has access to in the specified organization.", "parameters": [ { "default": "hello", "description": "Group slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "description": "access level", "in": "query", "name": "access", "type": "integer" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.OrganizationAccess" }, "type": "array" } } }, "path": "/user/groups/{group}", "method": "get" }; var user_repos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetRepos", "tags": ["Repositories"], "summary": "获取当前用户拥有指定权限及其以上权限的仓库。List repositories owned by the current user with the specified permissions or higher.", "parameters": [ { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": "", "description": "Filter by repositories", "in": "query", "name": "search", "type": "string" }, { "description": "RType", "enum": [ "private", "public", "encrypted" ], "in": "query", "name": "filter_type", "type": "string" }, { "default": "owner", "description": "最小仓库权限,默认owner。Minima repository permissions, default(owner)", "enum": [ "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "role", "type": "string" }, { "description": "仓库类型标记,逗号分隔。Repository type flags, comma separated", "enum": ["KnowledgeBase"], "in": "query", "name": "flags", "type": "string" }, { "description": "Order field,default(last_updated_at)", "enum": [ "created_at", "last_updated_at", "stars", "slug_path", "forks" ], "in": "query", "name": "order_by", "type": "string" }, { "default": false, "description": "排序顺序。Ordering.", "in": "query", "name": "desc", "type": "boolean" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/user/repos", "method": "get" }; var user_staredRepos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetUserAllStaredRepos", "tags": ["Repositories"], "summary": "获取当前用户 star 的仓库列表。List all stared repositories.", "parameters": [ { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": "", "description": "Filter by repositories", "in": "query", "name": "search", "type": "string" }, { "default": false, "description": "排序顺序。Ordering.", "in": "query", "name": "desc", "type": "boolean" }, { "description": "Order field,default(last_updated_at)", "enum": [ "created_at", "last_updated_at", "stars", "forks" ], "in": "query", "name": "order_by", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/user/stared-repos", "method": "get" }; var users_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "operationId": "GetUserInfoByName", "tags": ["Users"], "summary": "获取指定用户的详情信息。Get detailed information for a specified user.", "parameters": [{ "default": "someone", "description": "User Name", "in": "path", "name": "username", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UsersResult" } } }, "path": "/users/{username}", "method": "get" }; var users_activities_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetUserActivitiesByDate", "tags": ["Activities"], "summary": "获取个人动态活跃详情汇总", "parameters": [{ "default": "someone", "description": "UserName", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": "", "description": "查询日期,格式 yyyyMM,或者 yyyyMMdd", "in": "query", "name": "date", "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.ActivityDate" } } }, "path": "/users/{username}/activities", "method": "get" }; var users_avatar_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-profile:r", "operationId": "GetUserAvatar", "tags": ["Assets"], "summary": "获取指定用户的用户头像。Get the user's avatar.", "parameters": [{ "default": "someone", "description": "User Name", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "Size of the avatar. s or l", "in": "path", "name": "size", "required": true, "type": "string" }], "responses": {}, "path": "/users/{username}/avatar/{size}", "method": "get" }; var users_followers_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetFollowersByUserID", "tags": ["Followers"], "summary": "获取指定用户的粉丝列表。Get the followers list of specified user.", "parameters": [ { "default": "someone", "description": "User Name", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.UserFollowResult" }, "type": "array" } } }, "path": "/users/{username}/followers", "method": "get" }; var users_following_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetFollowingByUserID", "tags": ["Followers"], "summary": "获取指定用户的关注人列表。Get the list of users that the specified user is following.", "parameters": [ { "default": "someone", "description": "User Name", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.UserFollowResult" }, "type": "array" } } }, "path": "/users/{username}/following", "method": "get" }; var users_groups_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetGroupsByUserID", "tags": ["Organizations"], "summary": "获取指定用户拥有权限的顶层组织列表。 Get a list of top-level organizations that the specified user has permissions to access.", "parameters": [ { "default": "someone", "description": "UserName", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": "", "description": "Filter organizations.", "in": "query", "name": "search", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": false, "description": "Sort order.", "in": "query", "name": "desc", "type": "boolean" }, { "description": "Sort type, defaults to created_at", "enum": ["join_time", "created_at"], "in": "query", "name": "order_by", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.OrganizationUnion" } } }, "path": "/users/{username}/groups", "method": "get" }; var users_pinnedRepos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetPinnedRepoByID", "tags": ["Repositories"], "summary": "获取指定用户的用户仓库墙。 Get a list of repositories that the specified user has pinned.", "parameters": [{ "default": "someone", "description": "User Name", "in": "path", "name": "username", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/users/{username}/pinned-repos", "method": "get" }; var users_repoActivities_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetUserRepoActivityDetails", "tags": ["Activities"], "summary": "个人仓库动态详情列表", "parameters": [ { "default": "someone", "description": "UserName", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "activity type", "enum": [ "issue", "pull_request", "code_review" ], "in": "path", "name": "activityType", "required": true, "type": "string" }, { "default": "", "description": "仓库路径", "in": "query", "name": "slug", "required": true, "type": "string" }, { "default": "", "description": "查询日期,格式 yyyyMM,或者 yyyyMMdd", "in": "query", "name": "date", "required": true, "type": "string" } ], "responses": { "200": { "description": "返回 []dto.ActivityPullRequestDetail|[]dto.ActivityIssueDetail", "schema": { "items": {}, "type": "array" } } }, "path": "/users/{username}/repo-activities/{activityType}", "method": "get" }; var users_repos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetReposByUserName", "tags": ["Repositories"], "summary": "获取指定用户有指定以上权限并且客人态可见的仓库。List repositories where the specified user has the specified permission level or higher and are visible to guests.", "parameters": [ { "default": "someone", "description": "UserName", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": "", "description": "Filter by repositories", "in": "query", "name": "search", "type": "string" }, { "default": "owner", "description": "最小仓库权限,默认owner。Minima repository permissions, default(owner).", "enum": [ "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "role", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": false, "description": "排序顺序。Ordering.", "in": "query", "name": "desc", "type": "boolean" }, { "description": "Order field,default(last_updated_at)", "enum": [ "created_at", "last_updated_at", "stars", "slug_path", "forks" ], "in": "query", "name": "order_by", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/users/{username}/repos", "method": "get" }; var users_staredRepos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "GetUserStaredRepos", "tags": ["Starring"], "summary": "获取指定用户的 star 仓库列表。Get the list of repositories starred by the specified user.", "parameters": [ { "default": "someone", "description": "UserName", "in": "path", "name": "username", "required": true, "type": "string" }, { "default": "", "description": "过滤仓库。Filter by repositories", "in": "query", "name": "search", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "default": false, "description": "Ordering", "in": "query", "name": "desc", "type": "boolean" }, { "description": "Order field,default(last_updated_at)", "enum": [ "created_at", "last_updated_at", "stars", "forks" ], "in": "query", "name": "order_by", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/users/{username}/stared-repos", "method": "get" }; var workspace_delete_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:rw", "operationId": "DeleteWorkspace", "tags": ["Workspace"], "summary": "删除我的云原生开发环境。Delete my workspace.", "parameters": [{ "description": "params", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.WorkspaceDeleteReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.WorkspaceDeleteResult" } } }, "path": "/workspace/delete", "method": "post" }; var workspace_list_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \naccount-engage:r", "operationId": "ListWorkspaces", "tags": ["Workspace"], "summary": "获取我的云原生开发环境列表。List my workspaces.", "parameters": [ { "description": "Git branch name, e.g. \"main\"", "in": "query", "name": "branch", "type": "string" }, { "description": "查询结束时间。Query end time. format YYYY-MM-DD HH:mm:ssZZ, e.g. 2024-12-01 00:00:00+0800", "in": "query", "name": "end", "type": "string" }, { "description": "Pagination page number, default(1)", "in": "query", "name": "page", "type": "integer" }, { "description": "Pagination page size, default(20), max(100)", "in": "query", "name": "pageSize", "type": "integer" }, { "description": "Repository path, e.g. \"groupname/reponame\"", "in": "query", "name": "slug", "type": "string" }, { "description": "查询开始时间。Query start time. format YYYY-MM-DD HH:mm:ssZZ, e.g. 2024-12-01 00:00:00+0800", "in": "query", "name": "start", "type": "string" }, { "description": "开发环境状态,running: 开发环境已启动,closed:开发环境已关闭。Workspace status: \"running\" for started, \"closed\" for stopped.", "in": "query", "name": "status", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.WorkspaceListResult" } } }, "path": "/workspace/list", "method": "get" }; var group_delete = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-delete:rw", "operationId": "DeleteOrganization", "tags": ["Organizations"], "summary": "删除指定组织。Delete the specified organization.", "parameters": [{ "description": "group path", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "in": "header", "name": "x-cnb-identity-ticket", "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{group}", "method": "delete" }; var group_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:r", "operationId": "GetGroup", "tags": ["Organizations"], "summary": "获取指定组织信息。Get information for the specified organization.", "parameters": [{ "description": "group path", "in": "path", "name": "group", "required": true, "type": "string" }], "responses": { "200": { "description": "group", "schema": { "$ref": "#/definitions/dto.OrganizationAccess" } } }, "path": "/{group}", "method": "get" }; var group_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "UpdateOrganization", "tags": ["Organizations"], "summary": "更新组织信息, 可更新的内容为: 组织描述, 组织展示名称, 组织网站, 组织联系邮箱。Updates organization information including: description, display name, website URL and contact email.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "group information to update", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateGroupReq" } }], "responses": { "200": { "description": "OK" } }, "path": "/{group}", "method": "put" }; var group_avatar_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "UpdateGroupAvatar", "tags": ["Organizations"], "summary": "更新组织头像 URL 地址。Updates the organization avatar URL.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "group avatar url to update", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateGroupAvatarReq" } }], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/avatar", "method": "put" }; var group_inheritMembers_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "ListInheritMembersOfGroup", "tags": ["Collaborators"], "summary": "获取指定组织或仓库内的继承成员。List inherited members within specified organization or repository。", "parameters": [ { "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": "", "description": "过滤成员。Filter by member", "in": "query", "name": "search", "type": "string" }, { "description": "Role", "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "role", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.ListInheritMembers" }, "type": "array" } } }, "path": "/{group}/-/inherit-members", "method": "get" }; var group_logos_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "PutLogos", "tags": ["Assets"], "summary": "确认上传的logo。Confirms the uploaded logo.", "parameters": [{ "default": "test-group/test-repo", "description": "group", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "获取 uploadurl 时返回的token。The token returned when getting the uploadurl.", "in": "query", "name": "token", "required": true, "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/logos", "method": "put" }; var group_logos_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:r", "operationId": "GetLogos", "tags": ["Assets"], "summary": "发起一个获取 logo 的请求,返回内容或者 302 到某个地址。Post a request to fetch a logo and returns the content directly or a 302 redirect to the logo URL.", "parameters": [{ "default": "test-group", "description": "group", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "size", "in": "path", "name": "size", "type": "string" }], "responses": { "302": { "description": "Found" } }, "path": "/{group}/-/logos/{size}", "method": "get" }; var group_members_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "ListMembersOfGroup", "tags": ["Collaborators"], "summary": "获取指定组织或仓库内的所有直接成员。List all direct members within specified organization or repository.", "parameters": [ { "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "description": "Role", "enum": [ "Guest", "Reporter", "Developer", "Master", "Owner" ], "in": "query", "name": "role", "type": "string" }, { "default": "", "description": "过滤成员。Filter by member.", "in": "query", "name": "search", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.UsersWithAccessLevelInSlug" }, "type": "array" } } }, "path": "/{group}/-/members", "method": "get" }; var group_members_accessLevel_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "GetMemberAccessLevelOfGroup", "tags": ["Contributors"], "summary": "获取指定组织或仓库内, 访问成员在当前层级内的权限信息。Get permission information for accessing members at current level.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": true, "description": "是否包含继承的权限。If inherited permissions are included.", "in": "query", "name": "include_inherit", "type": "boolean" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.MemberAccessLevelInSlugUnion" } } }, "path": "/{group}/-/members/access-level", "method": "get" }; var group_members_delete = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "DeleteMembersOfGroup", "tags": ["Collaborators"], "summary": "删除指定组织或仓库的直接成员。Remove direct members from specified organization/repository.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/members/{username}", "method": "delete" }; var group_members_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "AddMembersOfGroup", "tags": ["Collaborators"], "summary": "添加成员。Add members.", "parameters": [ { "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "member information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/members/{username}", "method": "post" }; var group_members_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "UpdateMembersOfGroup", "tags": ["Collaborators"], "summary": "更新指定组织或仓库内的直接成员权限信息。Update permission information for direct members in specified organization/repository.", "parameters": [ { "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "member information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/members/{username}", "method": "put" }; var group_members_accessLevel_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "ListMemberAccessLevelOfGroup", "tags": ["Contributors"], "summary": "获取指定组织或仓库内指定成员的权限信息, 结果按组织层级来展示, 包含上层组织的权限继承信息。Get specified member's permissions with organizational hierarchy.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.MemberAccessLevel" }, "type": "array" } } }, "path": "/{group}/-/members/{username}/access-level", "method": "get" }; var group_pinnedRepos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "GetPinnedRepoByGroup", "tags": ["Repositories"], "summary": "获取指定组织的仓库墙列表。List the pinned repositories of a group.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4UserBase" }, "type": "array" } } }, "path": "/{group}/-/pinned-repos", "method": "get" }; var group_pinnedRepos_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "SetPinnedRepoByGroup", "tags": ["Repositories"], "summary": "更新指定组织仓库墙。Update the pinned repositories of a group.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "repo path", "in": "body", "name": "request", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4UserBase" }, "type": "array" } } }, "path": "/{group}/-/pinned-repos", "method": "put" }; var group_repos_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:r", "operationId": "GetGroupSubRepos", "tags": ["Repositories"], "summary": "查询组织下访问用户有权限查看到仓库。List the repositories that the user has access to.", "parameters": [ { "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "type": "integer" }, { "description": "Repositories type", "enum": [ "private", "public", "encrypted" ], "in": "query", "name": "filter_type", "type": "string" }, { "description": "Order field,default(last_updated_at)", "enum": [ "created_at", "last_updated_at", "stars", "slug_path" ], "in": "query", "name": "order_by", "type": "string" }, { "default": false, "description": "Ordering", "in": "query", "name": "desc", "type": "boolean" }, { "description": "查全部/查询直接属于当前组织的仓库/查询子组织的仓库。Get all/Get repos belong to current org or sub-organization", "enum": [ "all", "sub", "grand" ], "in": "query", "name": "descendant", "type": "string" }, { "description": "Key word", "in": "query", "name": "search", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.Repos4User" }, "type": "array" } } }, "path": "/{group}/-/repos", "method": "get" }; var group_repos_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:rw", "operationId": "CreateRepo", "tags": ["Repositories"], "summary": "创建仓库。Create repositories.", "parameters": [{ "default": "hello", "description": "Group slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "repo information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.CreateRepoReq" } }], "responses": { "201": { "description": "Created" } }, "path": "/{group}/-/repos", "method": "post" }; var group_settings_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:r", "operationId": "GetGroupSetting", "tags": ["Organizations"], "summary": "获取指定组织的配置详情。Get the configuration details for the specified organization.", "parameters": [{ "description": "group path", "in": "path", "name": "group", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.OrganizationSettingWithParent" } } }, "path": "/{group}/-/settings", "method": "get" }; var group_settings_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "UpdateGroupSetting", "tags": ["Organizations"], "summary": "更新指定组织的配置。Updates the configuration for the specified organization.", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "group information to update", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.GroupSettingReq" } }], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/settings", "method": "put" }; var group_subGroups_list = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-resource:r", "operationId": "ListSubgroups", "tags": ["Organizations"], "summary": "获取指定组织下的子组织列表。Get the list of sub-organizations under the specified organization.", "parameters": [ { "description": "Slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "default": "", "description": "Filter organization", "in": "query", "name": "search", "type": "string" }, { "default": 1, "description": "Pagination page number", "in": "query", "name": "page", "required": true, "type": "integer" }, { "default": 10, "description": "Pagination page size", "in": "query", "name": "page_size", "required": true, "type": "integer" } ], "responses": { "200": { "description": "OK", "schema": { "items": { "$ref": "#/definitions/dto.OrganizationUnion" }, "type": "array" } } }, "path": "/{group}/-/sub-groups", "method": "get" }; var group_transfer_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "TransferGroup", "tags": ["Organizations"], "summary": "转移组织", "parameters": [{ "description": "slug", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "request", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.TransferSlugReq" } }], "responses": { "200": { "description": "OK" } }, "path": "/{group}/-/transfer", "method": "post" }; var group_upload_logos_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \ngroup-manage:rw", "operationId": "UploadLogos", "tags": ["Assets"], "summary": "发起一个上传 logo 的请求,返回上传 cos 的 url 和 form 内容。Post a request to upload a logo.", "parameters": [{ "default": "test-group", "description": "group", "in": "path", "name": "group", "required": true, "type": "string" }, { "description": "UploadRequestParams", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UploadRequestParams" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.UploadAssetsResponse" } } }, "path": "/{group}/-/upload/logos", "method": "post" }; var mission_delete = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-delete:rw", "operationId": "DeleteMission", "tags": ["Missions"], "summary": "删除指定任务集。Delete the specified mission.", "parameters": [{ "description": "mission path", "in": "path", "name": "mission", "required": true, "type": "string" }, { "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "in": "header", "name": "x-cnb-identity-ticket", "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{mission}", "method": "delete" }; var mission_members_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nmission-manage:rw", "operationId": "AddMembersOfMission", "tags": ["Collaborators"], "summary": "添加成员。Add members.", "parameters": [ { "description": "slug", "in": "path", "name": "mission", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "member information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "path": "/{mission}/-/members/{username}", "method": "post" }; var registry_delete = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nregistry-delete:rw", "operationId": "DeleteRegistry", "tags": ["Artifactory"], "summary": "删除制品仓库。Delete the artifact repository.", "parameters": [{ "description": "registry path", "in": "path", "name": "registry", "required": true, "type": "string" }, { "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "in": "header", "name": "x-cnb-identity-ticket", "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{registry}", "method": "delete" }; var registry_members_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nregistry-manage:rw", "operationId": "AddMembersOfRegistry", "tags": ["Collaborators"], "summary": "添加成员。Add members.", "parameters": [ { "description": "slug", "in": "path", "name": "registry", "required": true, "type": "string" }, { "description": "username", "in": "path", "name": "username", "required": true, "type": "string" }, { "description": "member information", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateMembersRequest" } } ], "responses": { "200": { "description": "OK" } }, "path": "/{registry}/-/members/{username}", "method": "post" }; var repo_delete = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-delete:rw", "operationId": "DeleteRepo", "tags": ["Repositories"], "summary": "删除指定仓库。Delete the specified repository.", "parameters": [{ "description": "repo path", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "微信身份验证票据,首次请求不传会返回新票据。WeChat auth ticket, will return new ticket if not provided in first request.", "in": "header", "name": "x-cnb-identity-ticket", "type": "string" }], "responses": { "200": { "description": "OK" } }, "path": "/{repo}", "method": "delete" }; var repo_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-basic-info:r", "operationId": "GetByID", "tags": ["Repositories"], "summary": "获取指定仓库信息。Get information for the specified repository.", "parameters": [{ "description": "repo path", "in": "path", "name": "repo", "required": true, "type": "string" }], "responses": { "200": { "description": "repo", "schema": { "$ref": "#/definitions/dto.Repos4User" } } }, "path": "/{repo}", "method": "get" }; var repo_patch = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-manage:rw", "operationId": "UpdateRepo", "tags": ["Repositories"], "summary": "更新仓库信息, 可更新的内容为: 仓库简介, 仓库站点, 仓库主题, 开源许可证。updates repository details including description, website URL,topics and license type.", "parameters": [{ "description": "repo path", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "request body", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.RepoPatch" } }], "responses": { "200": { "description": "OK" } }, "path": "/{repo}", "method": "patch" }; var repo_build_logs_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:r", "operationId": "GetBuildLogs", "tags": ["Build"], "summary": "查询流水线构建列表。List pipeline builds.", "parameters": [ { "description": "Repo path", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "Start date in \"YYYY-MM-DD\" format, e.g. \"2024-12-01\"", "in": "query", "name": "createTime", "type": "string" }, { "description": "End date in \"YYYY-MM-DD\" format, e.g. \"2024-12-01\"", "in": "query", "name": "endTime", "type": "string" }, { "description": "Event name, e.g. \"push\"", "in": "query", "name": "event", "type": "string" }, { "description": "Pagination page number, default(1)", "in": "query", "name": "page", "type": "integer" }, { "description": "Pagination page size, default(20), max(100)", "in": "query", "name": "pagesize", "type": "integer" }, { "description": "Commit ID, e.g. \"2221d4535ec0c921bcd0858627c5025a871dd2b5\"", "in": "query", "name": "sha", "type": "string" }, { "description": "Build SN, e.g. \"cnb-1qa-1i3f5ecau", "in": "query", "name": "sn", "type": "string" }, { "description": "Source branch name, e.g. \"dev\"", "in": "query", "name": "sourceRef", "type": "string" }, { "description": "Build status: \"pending\", \"success\", \"error\", \"cancel\"", "in": "query", "name": "status", "type": "string" }, { "description": "Target branch name, e.g. \"main\"", "in": "query", "name": "targetRef", "type": "string" }, { "description": "User ID", "in": "query", "name": "userId", "type": "string" }, { "description": "Username", "in": "query", "name": "userName", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildLogsResult" } } }, "path": "/{repo}/-/build/logs", "method": "get" }; var repo_build_start_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:rw", "operationId": "StartBuild", "tags": ["Build"], "summary": "开始一个构建。Start a build.", "parameters": [{ "description": "repo", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "Build params", "in": "body", "name": "request", "required": true, "schema": { "$ref": "#/definitions/dto.StartBuildReq" } }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildResult" } } }, "path": "/{repo}/-/build/start", "method": "post" }; var repo_build_status_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:r", "operationId": "GetBuildStatus", "tags": ["Build"], "summary": "查询流水线构建状态。Get pipeline build status.", "parameters": [{ "description": "Repo path", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "SN", "in": "path", "name": "sn", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildStatusResult" } } }, "path": "/{repo}/-/build/status/{sn}", "method": "get" }; var repo_build_stop_post = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-cnb-trigger:rw", "operationId": "StopBuild", "tags": ["Build"], "summary": "停止一个构建。 Stop a build.", "parameters": [{ "description": "repo", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "SN", "in": "path", "name": "sn", "required": true, "type": "string" }], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/dto.BuildResult" } } }, "path": "/{repo}/-/build/stop/{sn}", "method": "post" }; var repo_commitAssets_download_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-contents:r", "operationId": "GetCommitAssets", "tags": ["Assets"], "summary": "发起一个获取 commits 附件的请求,返回内容或者 302 到某个地址。Get a request to fetch a commit assets and returns the content directly or a 302 redirect to the assets URL.", "parameters": [ { "default": "test-group/test-repo", "description": "Repo", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "File path that contain commit hash,eg: 3bba1ce6a8c35ee1264c7449f4f0b512bd751eac/test.png", "in": "path", "name": "fileName", "required": true, "type": "string" }, { "default": false, "description": "true 的话 302 的下载地址有效期为12个小时,但最多只能下载10次", "in": "query", "name": "share", "type": "boolean" } ], "responses": { "302": { "description": "Found" } }, "path": "/{repo}/-/commit-assets/download/{fileName}", "method": "get" }; var repo_contributor_trend_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-code:r", "operationId": "GetRepoContributorTrend", "tags": ["RepoContributor"], "summary": "查询仓库贡献者前 100 名的详细趋势数据。Query detailed trend data for top 100 contributors of the repository.", "parameters": [ { "description": "slug", "in": "path", "name": "repo", "required": true, "type": "string" }, { "default": 14, "description": "limit, 0~100", "in": "query", "name": "limit", "type": "integer" }, { "default": false, "description": "exclude_external_users, true|false", "in": "query", "name": "exclude_external_users", "type": "boolean" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/web.RepoContribTrend" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/die.WebError" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/die.WebError" } } }, "path": "/{repo}/-/contributor/trend", "method": "get" }; var repo_files_get = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-contents:r", "operationId": "GetFiles", "tags": ["Assets"], "summary": "发起一个获取 files 的请求,返回内容或者 302 到某个地址。Initiate a request to retrieve files, returns content or 302 redirect.", "parameters": [ { "default": "test-group/test-repo", "description": "repo", "in": "path", "name": "repo", "required": true, "type": "string" }, { "description": "user_id_key", "in": "path", "name": "userIdKey", "required": true, "type": "string" }, { "description": "random_uuid", "in": "path", "name": "randomUUID", "required": true, "type": "string" }, { "description": "file_name", "in": "path", "name": "fileName", "required": true, "type": "string" } ], "responses": { "302": { "description": "Found" } }, "path": "/{repo}/-/files/{userIdKey}/{randomUUID}/{fileName}", "method": "get" }; var repo_files_put = { "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-contents:rw", "operationI