{ "swagger": "2.0", "info": { "title": "CNB OPENAPI", "contact": { "name": "Open API Support", "url": "https://docs.cnb.cool/", "email": "cnb@tencent.com" }, "version": "1.0" }, "paths": { "/{repo}/-/assets/{assetID}": { "delete": { "security": [ { "BearerAuth": [] } ], "description": "通过 asset 记录 id 删除一个 asset,release和commit附件不能通过该接口删除\n访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-manage:rw", "tags": [ "Assets" ], "summary": "通过 asset 记录 id 删除一个 asset", "operationId": "DeleteAsset", "parameters": [ { "type": "string", "description": "repo", "name": "repo", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "asset id", "name": "assetID", "in": "path", "required": true } ], "responses": { "200": { "description": "OK" }, "422": { "description": "release和commit附件不能通过该接口删除", "schema": { "$ref": "#/definitions/die.WebError" } } } } }, "/{slug}/-/list-assets": { "get": { "security": [ { "BearerAuth": [] } ], "consumes": [ "application/json" ], "produces": [ "application/vnd.cnb.api+json" ], "tags": [ "Assets" ], "summary": "仓库的 asset 记录列表", "operationId": "ListAssets", "parameters": [ { "type": "string", "description": "slug", "name": "slug", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "第几页,从1开始", "name": "page", "in": "query" }, { "type": "integer", "default": 10, "description": "每页多少条数据", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/dto.AssetRecords" } } } }, "description": "访问令牌调用此接口需包含以下权限。Required permissions for access token. \nrepo-manage:r" } } }, "definitions": { "die.WebError": { "type": "object", "properties": { "errcode": { "type": "integer" }, "errmsg": { "type": "string" }, "errparam": { "type": "object", "additionalProperties": {} } } }, "dto.AssetRecords": { "type": "object", "properties": { "id": { "type": "string" }, "origin_path": { "description": "来源地址,例如 release 附件的来源地址是对应的 release 页面。issue和pr文件没有。", "type": "string" }, "path": { "type": "string" }, "record_type": { "description": "资源类型,slug_img和slug_file可调用DeleteAsset接口直接删除该资源,repo_release和repo_commit则不行", "allOf": [ { "$ref": "#/definitions/dto.AssetRecordType" } ] }, "referer": { "type": "string" }, "size_in_byte": { "type": "integer" } } } } }