feat(swagger): add descriptions for publish tasks and query parameters
Backend CI / Backend (push) Successful in 15m9s

This commit is contained in:
2026-05-07 14:26:14 +08:00
parent c26da5cf72
commit 73f1b2aca8
2 changed files with 4 additions and 0 deletions
@@ -67,6 +67,8 @@ var routeDocs = map[string]routeDoc{
"POST /api/tenant/accounts/:id/request-delete": {"申请删除媒体账号", "由后台发起异步删除,桌面端确认后真正解绑。"},
"POST /api/tenant/tasks/:id/reconcile": {"对账发布任务", "管理后台对发布任务做对账:状态校正、结果回填。"},
"POST /api/tenant/tasks/:id/cancel": {"取消发布任务(后台)", "管理员在后台取消还未派发或还在执行的发布任务。"},
"GET /api/tenant/publish-tasks": {"发布任务列表(后台)", "管理后台分页查询本 Workspace 下的发布队列与历史发送结果。"},
"POST /api/tenant/publish-tasks/:id/retry": {"重试发布任务(后台)", "管理后台对失败的发布任务重新创建一次发布任务。"},
"POST /api/tenant/publish-jobs": {"批量创建发布任务", "为一批文章/账号批量生成发布任务,进入派发队列。"},
// --- Tenant:媒体 ---
@@ -331,6 +331,8 @@ func queryParameterNames(route gin.RouteInfo) []string {
add("period_days")
case strings.Contains(path, "/tenant/accounts/"):
add("undo")
case strings.Contains(path, "/tenant/publish-tasks"):
add("page", "page_size", "limit", "title")
case strings.Contains(path, "/desktop/accounts"):
add("client", "if_sync_version")
case strings.Contains(path, "/desktop/publish-tasks"):