{ "swagger": "2.0", "info": { "title": "攻略服务", "version": "1.0.0" }, "basePath": "/", "paths": { "/admin/guide/category": { "post": { "tags": [ "攻略分类管理" ], "summary": "创建分类", "description": "创建攻略分类，分类名称不可重复。创建后默认启用，排序值越小越靠前。\n\n**权限**：需管理员登录。", "operationId": "createCategoryUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/CategoryCreateRequest", "originalRef": "CategoryCreateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略分类»", "originalRef": "统一响应结果«攻略分类»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略分类»", "originalRef": "统一响应结果«攻略分类»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/category/enabled": { "get": { "tags": [ "攻略分类管理" ], "summary": "启用的分类列表", "description": "仅返回状态为启用的分类，创建文章时用于选择分类", "operationId": "listEnabledCategoriesUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略分类»»", "originalRef": "统一响应结果«List«攻略分类»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略分类»»", "originalRef": "统一响应结果«List«攻略分类»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/category/list": { "get": { "tags": [ "攻略分类管理" ], "summary": "分类列表", "description": "返回全部攻略分类（含启用和停用），按排序值升序排列\n\n**关联字典**：\n- common_status：通用状态（列表显示，ACTIVE=启用/INACTIVE=停用）", "operationId": "listCategoriesUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略分类»»", "originalRef": "统一响应结果«List«攻略分类»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略分类»»", "originalRef": "统一响应结果«List«攻略分类»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/category/{categoryId}": { "put": { "tags": [ "攻略分类管理" ], "summary": "更新分类", "description": "更新攻略分类的名称、图标、描述等信息。\n\n**权限**：需管理员登录。", "operationId": "updateCategoryUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "categoryId", "in": "path", "description": "categoryId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/CategoryUpdateRequest", "originalRef": "CategoryUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略分类»", "originalRef": "统一响应结果«攻略分类»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略分类»", "originalRef": "统一响应结果«攻略分类»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "攻略分类管理" ], "summary": "删除分类", "description": "删除分类前需确保分类下无文章，否则删除失败", "operationId": "deleteCategoryUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "categoryId", "in": "path", "description": "categoryId", "required": true, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/category/{categoryId}/sort": { "put": { "tags": [ "攻略分类管理" ], "summary": "更新分类排序", "description": "更新分类的排序值，排序值越小越靠前。影响小程序端分类导航的展示顺序。\n\n**权限**：需管理员登录。", "operationId": "updateSortUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "categoryId", "in": "path", "description": "categoryId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/CategorySortRequest", "originalRef": "CategorySortRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/category/{categoryId}/status": { "put": { "tags": [ "攻略分类管理" ], "summary": "更新分类状态", "description": "启用或停用分类。停用后该分类下的文章不会在小程序端展示，但不影响已有文章\n\n**关联字典**：\n- common_status：通用状态（状态切换，ACTIVE=启用/INACTIVE=停用）", "operationId": "updateStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "categoryId", "in": "path", "description": "categoryId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/StatusRequest", "originalRef": "StatusRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article": { "post": { "tags": [ "攻略文章管理" ], "summary": "创建文章", "description": "创建攻略文章，需指定分类。创建后默认为草稿状态，需手动发布后小程序端才可见。\n\n**权限**：需管理员登录。\n\n**关联字典**：\n- wiki_status：文章状态（创建后默认DRAFT）", "operationId": "createArticleUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/ArticleCreateRequest", "originalRef": "ArticleCreateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article/list": { "get": { "tags": [ "攻略文章管理" ], "summary": "文章列表", "description": "分页查询攻略文章，支持按分类、状态、关键词筛选\n\n**关联字典**：\n- wiki_status：文章状态（列表筛选+显示）", "operationId": "listArticlesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "categoryId", "in": "query", "description": "分类ID", "required": false, "type": "integer", "format": "int64" }, { "name": "isRecommend", "in": "query", "description": "是否推荐：0=否，1=是", "required": false, "type": "integer", "format": "int32" }, { "name": "isTop", "in": "query", "description": "是否置顶：0=否，1=是", "required": false, "type": "integer", "format": "int32" }, { "name": "keyword", "in": "query", "description": "关键词（搜索标题/摘要）", "required": false, "type": "string" }, { "name": "orderBy", "in": "query", "description": "排序字段：sortOrder/publishTime/viewCount/createdAt（默认createdAt）", "required": false, "type": "string" }, { "name": "orderDir", "in": "query", "description": "排序方向：asc/desc（默认desc）", "required": false, "type": "string" }, { "name": "page", "in": "query", "description": "页码（默认1）", "required": false, "type": "integer", "format": "int32" }, { "name": "pageSize", "in": "query", "description": "每页数量（默认20，最大100）", "required": false, "type": "integer", "format": "int32" }, { "name": "status", "in": "query", "description": "状态：0=草稿，1=已发布，2=已下架", "required": false, "type": "integer", "format": "int32" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«攻略文章列表项»»", "originalRef": "统一响应结果«分页结果«攻略文章列表项»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«攻略文章列表项»»", "originalRef": "统一响应结果«分页结果«攻略文章列表项»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article/{articleId}": { "get": { "tags": [ "攻略文章管理" ], "summary": "文章详情", "description": "**关联字典**：\n- wiki_status：文章状态（显示）", "operationId": "getArticleUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "攻略文章管理" ], "summary": "更新文章", "description": "更新攻略文章的标题、内容、封面图、分类等信息。已发布的文章更新后立即生效。\n\n**权限**：需管理员登录。", "operationId": "updateArticleUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/ArticleUpdateRequest", "originalRef": "ArticleUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略文章详情»", "originalRef": "统一响应结果«攻略文章详情»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "攻略文章管理" ], "summary": "删除文章", "description": "软删除攻略文章，同时清除文章的标签关联。\n\n**权限**：需管理员登录。", "operationId": "deleteArticleUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article/{articleId}/recommend": { "put": { "tags": [ "攻略文章管理" ], "summary": "设置推荐", "description": "设置/取消文章推荐。推荐文章会在小程序首页和推荐列表中优先展示", "operationId": "updateRecommendUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/RecommendRequest", "originalRef": "RecommendRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article/{articleId}/status": { "put": { "tags": [ "攻略文章管理" ], "summary": "发布/下架", "description": "切换文章发布状态。发布后小程序端可见，下架后小程序端不再展示但管理端仍可查看\n\n**关联字典**：\n- wiki_status：文章状态（状态切换）", "operationId": "updateStatusUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/StatusRequest", "originalRef": "StatusRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/article/{articleId}/top": { "put": { "tags": [ "攻略文章管理" ], "summary": "设置置顶", "description": "设置/取消文章置顶。置顶文章在分类列表中始终排在最前面", "operationId": "updateTopUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/TopRequest", "originalRef": "TopRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/tag": { "post": { "tags": [ "攻略标签管理" ], "summary": "创建标签", "description": "创建攻略系统标签，标签名称不可重复。创建后可用于文章分类和筛选。\n\n**权限**：需管理员登录。", "operationId": "createTagUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/TagCreateRequest", "originalRef": "TagCreateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略标签»", "originalRef": "统一响应结果«攻略标签»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略标签»", "originalRef": "统一响应结果«攻略标签»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/tag/all": { "get": { "tags": [ "攻略标签管理" ], "summary": "所有标签列表", "description": "返回全部标签（含系统标签和用户自定义标签），用于文章编辑时的标签选择器", "operationId": "listAllTagsUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略标签»»", "originalRef": "统一响应结果«List«攻略标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略标签»»", "originalRef": "统一响应结果«List«攻略标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/tag/article/{articleId}": { "put": { "tags": [ "攻略标签管理" ], "summary": "更新文章标签", "description": "全量替换文章的标签关联，传入新的标签ID列表（空数组表示清除所有标签）", "operationId": "updateArticleTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "articleId", "in": "path", "description": "articleId", "required": true, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/ArticleTagUpdateRequest", "originalRef": "ArticleTagUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/tag/managed": { "get": { "tags": [ "攻略标签管理" ], "summary": "系统标签列表", "description": "返回管理员创建的系统标签（不含用户自定义标签），用于标签管理页", "operationId": "listManagedTagsUsingGET", "produces": [ "*/*" ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略标签»»", "originalRef": "统一响应结果«List«攻略标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«List«攻略标签»»", "originalRef": "统一响应结果«List«攻略标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/guide/tag/{tagId}": { "put": { "tags": [ "攻略标签管理" ], "summary": "更新标签", "description": "更新标签名称。标签名称不可与其他已有标签重复。\n\n**权限**：需管理员登录。", "operationId": "updateTagUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "request", "required": true, "schema": { "$ref": "#/definitions/TagUpdateRequest", "originalRef": "TagUpdateRequest" } }, { "name": "tagId", "in": "path", "description": "tagId", "required": true, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略标签»", "originalRef": "统一响应结果«攻略标签»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«攻略标签»", "originalRef": "统一响应结果«攻略标签»" } }, "201": { "description": "Created" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "delete": { "tags": [ "攻略标签管理" ], "summary": "删除标签", "description": "删除标签并自动解除与所有文章的关联关系。\n\n**权限**：需管理员登录。", "operationId": "deleteTagUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "in": "path", "description": "tagId", "required": true, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«Void»", "originalRef": "统一响应结果«Void»" } }, "204": { "description": "No Content" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } }, "deprecated": false, "x-order": "2147483647" } } }, "definitions": { "CategoryCreateRequest": { "type": "object", "required": [ "categoryName" ], "properties": { "categoryName": { "type": "string", "description": "分类名称" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "description": { "type": "string", "description": "描述" }, "icon": { "type": "string", "description": "图标" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序（默认0）" } }, "title": "CategoryCreateRequest" }, "CategorySortRequest": { "type": "object", "required": [ "sortOrder" ], "properties": { "sortOrder": { "type": "integer", "format": "int32", "description": "排序值" } }, "title": "CategorySortRequest" }, "CategoryUpdateRequest": { "type": "object", "properties": { "categoryName": { "type": "string", "description": "分类名称" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "description": { "type": "string", "description": "描述" }, "icon": { "type": "string", "description": "图标" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" } }, "title": "CategoryUpdateRequest" }, "StatusRequest": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "integer", "format": "int32", "description": "状态值" } }, "title": "StatusRequest" }, "攻略分类": { "type": "object", "properties": { "articleCount": { "type": "integer", "format": "int32", "description": "文章数量" }, "categoryId": { "type": "integer", "format": "int64", "description": "分类ID" }, "categoryName": { "type": "string", "description": "分类名称" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "description": { "type": "string", "description": "描述" }, "icon": { "type": "string", "description": "图标" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=禁用，1=启用" } }, "title": "攻略分类" }, "统一响应结果«List«攻略分类»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/攻略分类", "originalRef": "攻略分类" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«攻略分类»»" }, "统一响应结果«Void»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«Void»" }, "统一响应结果«攻略分类»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/攻略分类", "originalRef": "攻略分类" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«攻略分类»" }, "ArticleCreateRequest": { "type": "object", "required": [ "categoryId", "title" ], "properties": { "authorName": { "type": "string", "description": "作者名称" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "integer", "format": "int64" } }, "categoryId": { "type": "integer", "format": "int64", "description": "分类ID" }, "content": { "type": "string", "description": "正文内容" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "resources": { "type": "array", "description": "关联资源列表", "items": { "$ref": "#/definitions/ArticleResourceItem", "originalRef": "ArticleResourceItem" } }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序（默认0）" }, "source": { "type": "string", "description": "来源" }, "subtitle": { "type": "string", "description": "副标题" }, "summary": { "type": "string", "description": "摘要" }, "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "integer", "format": "int64" } }, "title": { "type": "string", "description": "标题" } }, "title": "ArticleCreateRequest" }, "ArticleResourceItem": { "type": "object", "required": [ "resourceId", "resourceName", "resourceType" ], "properties": { "resourceId": { "type": "integer", "format": "int64", "description": "资源ID" }, "resourceName": { "type": "string", "description": "资源名称" }, "resourceType": { "type": "string", "description": "资源类型：SCENIC/RESTAURANT/HOTEL/ACTIVITY/PRODUCT" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" } }, "title": "ArticleResourceItem" }, "ArticleUpdateRequest": { "type": "object", "properties": { "authorName": { "type": "string", "description": "作者名称" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "integer", "format": "int64" } }, "categoryId": { "type": "integer", "format": "int64", "description": "分类ID" }, "content": { "type": "string", "description": "正文内容" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "resources": { "type": "array", "description": "关联资源列表", "items": { "$ref": "#/definitions/ArticleResourceItem", "originalRef": "ArticleResourceItem" } }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" }, "source": { "type": "string", "description": "来源" }, "subtitle": { "type": "string", "description": "副标题" }, "summary": { "type": "string", "description": "摘要" }, "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "integer", "format": "int64" } }, "title": { "type": "string", "description": "标题" } }, "title": "ArticleUpdateRequest" }, "RecommendRequest": { "type": "object", "required": [ "isRecommend" ], "properties": { "isRecommend": { "type": "integer", "format": "int32", "description": "是否推荐：0=否，1=是" } }, "title": "RecommendRequest" }, "TopRequest": { "type": "object", "required": [ "isTop" ], "properties": { "isTop": { "type": "integer", "format": "int32", "description": "是否置顶：0=否，1=是" } }, "title": "TopRequest" }, "分页结果«攻略文章列表项»": { "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "example": 1, "description": "当前页码" }, "pageSize": { "type": "integer", "format": "int32", "example": 20, "description": "每页条数" }, "records": { "type": "array", "description": "数据列表", "items": { "$ref": "#/definitions/攻略文章列表项", "originalRef": "攻略文章列表项" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«攻略文章列表项»" }, "攻略文章列表项": { "type": "object", "properties": { "articleId": { "type": "integer", "format": "int64", "description": "文章ID" }, "categoryId": { "type": "integer", "format": "int64", "description": "分类ID" }, "categoryName": { "type": "string", "description": "分类名称" }, "coverUrl": { "type": "string", "description": "封面URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "isRecommend": { "type": "integer", "format": "int32", "description": "是否推荐：0=否，1=是" }, "isTop": { "type": "integer", "format": "int32", "description": "是否置顶：0=否，1=是" }, "publishTime": { "type": "string", "format": "date-time", "description": "发布时间" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=草稿，1=已发布，2=已下架" }, "summary": { "type": "string", "description": "摘要" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/攻略标签", "originalRef": "攻略标签" } }, "title": { "type": "string", "description": "标题" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "攻略文章列表项" }, "攻略文章详情": { "type": "object", "properties": { "articleId": { "type": "integer", "format": "int64", "description": "文章ID" }, "authorName": { "type": "string", "description": "作者名称" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "integer", "format": "int64" } }, "categoryId": { "type": "integer", "format": "int64", "description": "分类ID" }, "categoryName": { "type": "string", "description": "分类名称" }, "content": { "type": "string", "description": "正文内容" }, "coverMaterialId": { "type": "integer", "format": "int64", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "favoriteCount": { "type": "integer", "format": "int32", "description": "收藏数" }, "isRecommend": { "type": "integer", "format": "int32", "description": "是否推荐：0=否，1=是" }, "isTop": { "type": "integer", "format": "int32", "description": "是否置顶：0=否，1=是" }, "likeCount": { "type": "integer", "format": "int32", "description": "点赞数" }, "publishTime": { "type": "string", "format": "date-time", "description": "发布时间" }, "resources": { "type": "array", "description": "关联资源列表", "items": { "$ref": "#/definitions/文章关联资源", "originalRef": "文章关联资源" } }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" }, "source": { "type": "string", "description": "来源" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=草稿，1=已发布，2=已下架" }, "subtitle": { "type": "string", "description": "副标题" }, "summary": { "type": "string", "description": "摘要" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/攻略标签", "originalRef": "攻略标签" } }, "title": { "type": "string", "description": "标题" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "攻略文章详情" }, "攻略标签": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色" }, "tagId": { "type": "integer", "format": "int64", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=系统管理，1=自定义" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "攻略标签" }, "文章关联资源": { "type": "object", "properties": { "resourceId": { "type": "integer", "format": "int64", "description": "资源ID" }, "resourceName": { "type": "string", "description": "资源名称" }, "resourceType": { "type": "string", "description": "资源类型：SCENIC/RESTAURANT/HOTEL/ACTIVITY/PRODUCT" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序" } }, "title": "文章关联资源" }, "统一响应结果«分页结果«攻略文章列表项»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«攻略文章列表项»", "originalRef": "分页结果«攻略文章列表项»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«攻略文章列表项»»" }, "统一响应结果«攻略文章详情»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/攻略文章详情", "originalRef": "攻略文章详情" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«攻略文章详情»" }, "ArticleTagUpdateRequest": { "type": "object", "required": [ "tagIds" ], "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "ArticleTagUpdateRequest" }, "TagCreateRequest": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=系统管理，1=自定义（默认0）" } }, "title": "TagCreateRequest" }, "TagUpdateRequest": { "type": "object", "properties": { "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "description": "标签名称" } }, "title": "TagUpdateRequest" }, "统一响应结果«List«攻略标签»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "type": "array", "description": "响应数据", "items": { "$ref": "#/definitions/攻略标签", "originalRef": "攻略标签" } }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«List«攻略标签»»" }, "统一响应结果«攻略标签»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/攻略标签", "originalRef": "攻略标签" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«攻略标签»" } } }