This commit is contained in:
2025-09-01 20:46:56 +08:00
parent 5d5372e359
commit 5c5c2abfcd
8 changed files with 1370 additions and 1187 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -1035,11 +1035,42 @@ definitions:
view_count:
type: integer
type: object
responses.ArticleListItemResponse:
properties:
category:
$ref: '#/definitions/tyapi-server_internal_application_article_dto_responses.CategoryInfoResponse'
category_id:
type: string
cover_image:
type: string
created_at:
type: string
id:
type: string
is_featured:
type: boolean
published_at:
type: string
status:
type: string
summary:
type: string
tags:
items:
$ref: '#/definitions/responses.TagInfoResponse'
type: array
title:
type: string
updated_at:
type: string
view_count:
type: integer
type: object
responses.ArticleListResponse:
properties:
items:
items:
$ref: '#/definitions/responses.ArticleInfoResponse'
$ref: '#/definitions/responses.ArticleListItemResponse'
type: array
page:
type: integer
@@ -2320,7 +2351,7 @@ paths:
- Bearer: []
summary: 创建分类
tags:
- 文章分类管理
- 文章分类-管理
/api/v1/admin/article-categories/{id}:
delete:
consumes:
@@ -2364,7 +2395,7 @@ paths:
- Bearer: []
summary: 删除分类
tags:
- 文章分类管理
- 文章分类-管理
put:
consumes:
- application/json
@@ -2413,7 +2444,7 @@ paths:
- Bearer: []
summary: 更新分类
tags:
- 文章分类管理
- 文章分类-管理
/api/v1/admin/article-tags:
post:
consumes:
@@ -2453,7 +2484,7 @@ paths:
- Bearer: []
summary: 创建标签
tags:
- 文章标签管理
- 文章标签-管理
/api/v1/admin/article-tags/{id}:
delete:
consumes:
@@ -2497,7 +2528,7 @@ paths:
- Bearer: []
summary: 删除标签
tags:
- 文章标签管理
- 文章标签-管理
put:
consumes:
- application/json
@@ -2546,7 +2577,278 @@ paths:
- Bearer: []
summary: 更新标签
tags:
- 文章标签管理
- 文章标签-管理
/api/v1/admin/articles:
post:
consumes:
- application/json
description: 创建新的文章
parameters:
- description: 创建文章请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.CreateArticleCommand'
produces:
- application/json
responses:
"201":
description: 文章创建成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 创建文章
tags:
- 文章管理-管理端
/api/v1/admin/articles/{id}:
delete:
consumes:
- application/json
description: 删除指定文章
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章删除成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 删除文章
tags:
- 文章管理-管理端
put:
consumes:
- application/json
description: 更新文章信息
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
- description: 更新文章请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.UpdateArticleCommand'
produces:
- application/json
responses:
"200":
description: 文章更新成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 更新文章
tags:
- 文章管理-管理端
/api/v1/admin/articles/{id}/archive:
post:
consumes:
- application/json
description: 将已发布文章归档
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章归档成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 归档文章
tags:
- 文章管理-管理端
/api/v1/admin/articles/{id}/featured:
put:
consumes:
- application/json
description: 设置文章的推荐状态
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
- description: 设置推荐状态请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.SetFeaturedCommand'
produces:
- application/json
responses:
"200":
description: 设置推荐状态成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 设置推荐状态
tags:
- 文章管理-管理端
/api/v1/admin/articles/{id}/publish:
post:
consumes:
- application/json
description: 将草稿文章发布
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章发布成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 发布文章
tags:
- 文章管理-管理端
/api/v1/admin/articles/{id}/schedule-publish:
post:
consumes:
@@ -2596,7 +2898,7 @@ paths:
- Bearer: []
summary: 定时发布文章
tags:
- 文章管理
- 文章管理-管理端
/api/v1/admin/articles/stats:
get:
consumes:
@@ -2623,7 +2925,7 @@ paths:
- Bearer: []
summary: 获取文章统计
tags:
- 文章管理
- 文章管理-管理端
/api/v1/admin/invoices/{application_id}/approve:
post:
consumes:
@@ -4256,7 +4558,7 @@ paths:
type: object
summary: 获取分类列表
tags:
- 文章分类
- 文章分类-用户端
/api/v1/article-categories/{id}:
get:
consumes:
@@ -4292,7 +4594,7 @@ paths:
type: object
summary: 获取分类详情
tags:
- 文章分类
- 文章分类-用户端
/api/v1/article-tags:
get:
consumes:
@@ -4312,7 +4614,7 @@ paths:
type: object
summary: 获取标签列表
tags:
- 文章标签
- 文章标签-用户端
/api/v1/article-tags/{id}:
get:
consumes:
@@ -4348,7 +4650,7 @@ paths:
type: object
summary: 获取标签详情
tags:
- 文章标签
- 文章标签-用户端
/api/v1/articles:
get:
consumes:
@@ -4416,90 +4718,8 @@ paths:
type: object
summary: 获取文章列表
tags:
- 文章管理
post:
consumes:
- application/json
description: 创建新的文章
parameters:
- description: 创建文章请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.CreateArticleCommand'
produces:
- application/json
responses:
"201":
description: 文章创建成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 创建文章
tags:
- 文章管理
- 文章管理-用户端
/api/v1/articles/{id}:
delete:
consumes:
- application/json
description: 删除指定文章
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章删除成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 删除文章
tags:
- 文章管理
get:
consumes:
- application/json
@@ -4522,11 +4742,6 @@ paths:
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
@@ -4537,198 +4752,9 @@ paths:
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 获取文章详情
tags:
- 文章管理
put:
consumes:
- application/json
description: 更新文章信息
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
- description: 更新文章请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.UpdateArticleCommand'
produces:
- application/json
responses:
"200":
description: 文章更新成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 更新文章
tags:
- 文章管理
/api/v1/articles/{id}/archive:
post:
consumes:
- application/json
description: 将已发布文章归档
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章归档成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 归档文章
tags:
- 文章管理
/api/v1/articles/{id}/featured:
put:
consumes:
- application/json
description: 设置文章的推荐状态
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
- description: 设置推荐状态请求
in: body
name: request
required: true
schema:
$ref: '#/definitions/commands.SetFeaturedCommand'
produces:
- application/json
responses:
"200":
description: 设置推荐状态成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 设置推荐状态
tags:
- 文章管理
/api/v1/articles/{id}/publish:
post:
consumes:
- application/json
description: 将草稿文章发布
parameters:
- description: 文章ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: 文章发布成功
schema:
additionalProperties: true
type: object
"400":
description: 请求参数错误
schema:
additionalProperties: true
type: object
"401":
description: 未认证
schema:
additionalProperties: true
type: object
"404":
description: 文章不存在
schema:
additionalProperties: true
type: object
"500":
description: 服务器内部错误
schema:
additionalProperties: true
type: object
security:
- Bearer: []
summary: 发布文章
tags:
- 文章管理
- 文章管理-用户端
/api/v1/categories:
get:
consumes: