| 1 |
- {"openapi":"3.1.0","info":{"title":"Serve API","description":"Serve应用接口文档","contact":{"name":"杨逸"},"version":"0.0.1-SNAPSHOT"},"servers":[{"url":"http://localhost:8080","description":"Generated server url"}],"tags":[{"name":"SystemConfigController","description":"系统配置"},{"name":"AuthController","description":"用户认证相关接口"},{"name":"NotificationController","description":"系统通知"},{"name":"TipOrderController","description":"打赏订单"},{"name":"RealnameAuthController","description":"实名认证"},{"name":"WalletController","description":"钱包管理"},{"name":"PostController","description":"帖子管理"},{"name":"AttachmentController","description":"附件上传"}],"paths":{"/user":{"get":{"tags":["user-controller"],"operationId":"queryByPage","parameters":[{"name":"account","in":"query","required":true,"schema":{"type":"string","default":""}},{"name":"username","in":"query","required":true,"schema":{"type":"string","default":""}},{"name":"role","in":"query","required":true,"schema":{"type":"string","default":""}},{"name":"enable","in":"query","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageNum","in":"query","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":true,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePageVoListUserVo"}}}}}},"put":{"tags":["user-controller"],"operationId":"edit","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseBoolean"}}}}}},"post":{"tags":["user-controller"],"operationId":"add","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseBoolean"}}}}}},"delete":{"tags":["user-controller"],"operationId":"deleteById","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseBoolean"}}}}}}},"/user/{id}/role":{"put":{"tags":["user-controller"],"operationId":"updateRole","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/user/updateStatus":{"put":{"tags":["user-controller"],"operationId":"updateUserStatus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserStatusDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}},"/user/updatePassword":{"put":{"tags":["user-controller"],"operationId":"updatePassword","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserPasswordDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}},"/user/updateAvatar":{"put":{"tags":["user-controller"],"operationId":"updateUserAvatar","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserAvatarDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}},"/api/wallet/withdraw/{id}/review":{"put":{"tags":["WalletController"],"summary":"审核提现（管理员）","operationId":"reviewWithdraw","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/realname/{id}/review":{"put":{"tags":["RealnameAuthController"],"summary":"管理员审核实名认证","operationId":"review","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/posts/{id}":{"get":{"tags":["PostController"],"summary":"获取帖子详情","operationId":"getPostDetail","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePostVo"}}}}}},"put":{"tags":["PostController"],"summary":"更新帖子（管理员）","operationId":"updatePost","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}},"delete":{"tags":["PostController"],"summary":"删除帖子（管理员，逻辑删除）","operationId":"deletePost","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/posts/{id}/view-count":{"put":{"tags":["PostController"],"summary":"修改查看人数（管理员）","operationId":"updateViewCount","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"integer","format":"int32"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/posts/{id}/hit-status":{"put":{"tags":["PostController"],"summary":"设置命中状态（管理员）","operationId":"updateHitStatus","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/notifications/{id}/read":{"put":{"tags":["NotificationController"],"summary":"标记已读","operationId":"markRead","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/config/{key}":{"get":{"tags":["SystemConfigController"],"summary":"获取配置","operationId":"getConfig","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseObject"}}}}}},"put":{"tags":["SystemConfigController"],"summary":"更新配置（管理员）","operationId":"updateConfig","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/meta/updateWebsiteMeta":{"post":{"tags":["meta-controller"],"operationId":"updateWebsiteMeta","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteMetaDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}},"/auth/register":{"post":{"tags":["AuthController"],"summary":"用户注册","operationId":"register","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseAuthTokenVo"}}}}}}},"/auth/login":{"post":{"tags":["AuthController"],"summary":"用户登录","operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseAuthTokenVo"}}}}}}},"/api/wallet/withdraw":{"post":{"tags":["WalletController"],"summary":"提现申请","operationId":"applyWithdraw","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"number"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/wallet/recharge":{"post":{"tags":["WalletController"],"summary":"充值（预留接口，待对接支付平台）","operationId":"recharge","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"number"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/wallet/admin-recharge":{"post":{"tags":["WalletController"],"summary":"管理员代充值","operationId":"adminRecharge","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/realname":{"get":{"tags":["RealnameAuthController"],"summary":"查询自己的认证信息","operationId":"getMyAuth","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealnameAuthVo"}}}}}},"post":{"tags":["RealnameAuthController"],"summary":"提交实名认证","operationId":"submit","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}},"/api/posts":{"get":{"tags":["PostController"],"summary":"获取帖子列表","operationId":"listPosts","parameters":[{"name":"keyword","in":"query","required":false,"schema":{"type":"string","default":""}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"all"}},{"name":"pageNum","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePageVoListPostVo"}}}}}},"post":{"tags":["PostController"],"summary":"创建帖子（仅专家/管理员）","operationId":"createPost","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostDto"}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/orders/tip":{"post":{"tags":["TipOrderController"],"summary":"打赏并即时扣款","operationId":"createAndPay","parameters":[{"name":"X-Request-Id","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"integer","format":"int64"}}}},"required":true},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/attachments/upload":{"post":{"tags":["AttachmentController"],"summary":"上传附件到OSS（需对接OSS配置）","operationId":"upload","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","default":"post_image"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringString"}}}}}}},"/user/{id}":{"get":{"tags":["user-controller"],"operationId":"queryById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseUserVo"}}}}}}},"/user/profile":{"get":{"tags":["user-controller"],"operationId":"profile","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/meta/getWebsiteMeta":{"get":{"tags":["meta-controller"],"operationId":"getWebsiteMeta","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}},"/api/wallet/withdraw/pending":{"get":{"tags":["WalletController"],"summary":"获取待审核提现列表（管理员）","operationId":"listPendingWithdrawals","parameters":[{"name":"pageNum","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListWalletTransactionVo"}}}}}}},"/api/wallet/transactions":{"get":{"tags":["WalletController"],"summary":"资金明细","operationId":"getTransactions","parameters":[{"name":"pageNum","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/wallet/balance":{"get":{"tags":["WalletController"],"summary":"查询余额","operationId":"getBalance","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}}}}},"/api/realname/pending":{"get":{"tags":["RealnameAuthController"],"summary":"获取所有待审核认证（管理员）","operationId":"listPending","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRealnameAuthVo"}}}}}}},"/api/posts/expert/{expertId}/previous":{"get":{"tags":["PostController"],"summary":"获取专家往期帖子","operationId":"listPreviousPosts","parameters":[{"name":"expertId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"pageNum","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePageVoListPostVo"}}}}}}},"/api/orders":{"get":{"tags":["TipOrderController"],"summary":"获取我的打赏订单列表","operationId":"listOrders","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"all"}},{"name":"pageNum","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePageVoListOrderTipVo"}}}}}}},"/api/notifications":{"get":{"tags":["NotificationController"],"summary":"获取通知列表","operationId":"listNotifications","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListNotificationVo"}}}}}}},"/api/notifications/unread-count":{"get":{"tags":["NotificationController"],"summary":"获取未读数","operationId":"getUnreadCount","responses":{"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListFieldError"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringLong"}}}}}}}},"components":{"schemas":{"FieldError":{"type":"object","properties":{"codes":{"type":"array","items":{"type":"string"}},"arguments":{"type":"array","items":{}},"defaultMessage":{"type":"string"},"objectName":{"type":"string"},"field":{"type":"string"},"rejectedValue":{},"bindingFailure":{"type":"boolean"},"code":{"type":"string"}}},"ResponseListFieldError":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"array","description":"响应的具体数据","items":{"$ref":"#/components/schemas/FieldError"}}}},"UserDto":{"type":"object","description":"用户新增和修改使用的DTO","properties":{"id":{"type":"string","description":"用户ID"},"account":{"type":"string","description":"用户账号","maxLength":20,"minLength":4},"password":{"type":"string","description":"用户密码","maxLength":20,"minLength":4},"username":{"type":"string","description":"用户名称","maxLength":32,"minLength":2},"role":{"type":"string","description":"用户角色","maxLength":32,"minLength":4}},"required":["account","password","role","username"]},"ResponseBoolean":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"boolean","description":"响应的具体数据"}}},"ResponseVoid":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"description":"响应的具体数据"}}},"UpdateUserStatusDto":{"type":"object","description":"用户状态更新使用的DTO","properties":{"id":{"type":"string","description":"用户ID","minLength":1},"enable":{"type":"integer","format":"int32","description":"更新后的状态;1:启用,0:禁用","maximum":1,"minLength":1,"minimum":0}},"required":["enable","id"]},"Response":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"description":"响应的具体数据"}}},"UpdateUserPasswordDto":{"type":"object","description":"用户密码修改使用的DTO","properties":{"id":{"type":"string","description":"用户ID","minLength":1},"password":{"type":"string","description":"用户的当前密码","maxLength":20,"minLength":4},"oldPassword":{"type":"string","description":"用户的新密码","maxLength":20,"minLength":4}},"required":["id","oldPassword","password"]},"UpdateUserAvatarDto":{"type":"object","description":"更新用户头像的实体DTO","properties":{"id":{"type":"string","description":"用户的ID","minLength":1},"avatar":{"type":"string","description":"头像地址的链接","minLength":1,"pattern":"^(https?)://[^\\s/$.?#].[^\\s]*$"}},"required":["avatar","id"]},"PostDto":{"type":"object","description":"帖子创建/编辑请求","properties":{"title":{"type":"string","description":"帖子标题（含期号）","minLength":1},"contentIntro":{"type":"string","description":"内容简介（公开）"},"contentPaid":{"type":"string","description":"付费内容"},"price":{"type":"number","description":"打赏金额"},"expireTime":{"type":"string","format":"date-time","description":"过期时间，超出此时间自动转为公开"}},"required":["expireTime","price","title"]},"WebsiteMetaDto":{"type":"object","description":"网站元数据DTO，用于更新网站配置信息","properties":{"title":{"type":"string","description":"网站标题","maxLength":200,"minLength":0},"logo":{"type":"string","description":"网站logo URL","maxLength":500,"minLength":0},"statement":{"type":"string","description":"网站声明","maxLength":500,"minLength":0},"announcement":{"type":"string","description":"网站公告","maxLength":500,"minLength":0}}},"RegisterDto":{"type":"object","description":"注册请求参数","properties":{"account":{"type":"string","description":"账号","maxLength":20,"minLength":4},"password":{"type":"string","description":"密码","maxLength":20,"minLength":4},"username":{"type":"string","description":"用户名","maxLength":32,"minLength":2}},"required":["account","password","username"]},"AuthTokenVo":{"type":"object","description":"登录响应","properties":{"token":{"type":"string","description":"JWT token"},"userId":{"type":"integer","format":"int64","description":"用户ID"},"account":{"type":"string","description":"账号"},"username":{"type":"string","description":"用户名"},"role":{"type":"string","description":"角色"}}},"ResponseAuthTokenVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/AuthTokenVo","description":"响应的具体数据"}}},"LoginDto":{"type":"object","description":"登录请求参数","properties":{"account":{"type":"string","description":"账号","minLength":1},"password":{"type":"string","description":"密码","minLength":1}},"required":["account","password"]},"ResponseMapStringObject":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"object","additionalProperties":{},"description":"响应的具体数据"}}},"ResponseMapStringString":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"object","additionalProperties":{"type":"string"},"description":"响应的具体数据"}}},"PageVoListUserVo":{"type":"object","description":"分页数据对象","properties":{"total":{"type":"integer","format":"int64","description":"总数据条数"},"data":{"type":"array","description":"当前页的数据","items":{"$ref":"#/components/schemas/UserVo"}}}},"ResponsePageVoListUserVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/PageVoListUserVo","description":"响应的具体数据"}}},"UserVo":{"type":"object","description":"用户响应展示对象","properties":{"id":{"type":"string","description":"用户ID"},"account":{"type":"string","description":"用户账号"},"username":{"type":"string","description":"用户名称"},"role":{"type":"string","description":"用户角色"},"avatar":{"type":"string","description":"用户头像地址"},"enable":{"type":"integer","format":"int32","description":"用户状态;0:禁用,1:启用"}}},"ResponseUserVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/UserVo","description":"响应的具体数据"}}},"ResponseListWalletTransactionVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"array","description":"响应的具体数据","items":{"$ref":"#/components/schemas/WalletTransactionVo"}}}},"WalletTransactionVo":{"type":"object","description":"钱包流水视图","properties":{"id":{"type":"string"},"type":{"type":"string"},"amount":{"type":"number"},"balanceBefore":{"type":"number"},"balanceAfter":{"type":"number"},"status":{"type":"string"},"remark":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}},"RealnameAuthVo":{"type":"object","description":"实名认证视图","properties":{"id":{"type":"string"},"userId":{"type":"string"},"realName":{"type":"string"},"idCard":{"type":"string"},"idCardFront":{"type":"string"},"idCardBack":{"type":"string"},"status":{"type":"string"},"rejectReason":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}},"ResponseRealnameAuthVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/RealnameAuthVo","description":"响应的具体数据"}}},"ResponseListRealnameAuthVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"array","description":"响应的具体数据","items":{"$ref":"#/components/schemas/RealnameAuthVo"}}}},"PageVoListPostVo":{"type":"object","description":"分页数据对象","properties":{"total":{"type":"integer","format":"int64","description":"总数据条数"},"data":{"type":"array","description":"当前页的数据","items":{"$ref":"#/components/schemas/PostVo"}}}},"PostVo":{"type":"object","description":"帖子响应视图","properties":{"id":{"type":"string"},"expertId":{"type":"string"},"expertName":{"type":"string"},"expertAvatar":{"type":"string"},"title":{"type":"string"},"contentIntro":{"type":"string"},"contentPaid":{"type":"string"},"price":{"type":"number"},"hitStatus":{"type":"string"},"viewCount":{"type":"integer","format":"int32"},"isPublic":{"type":"boolean"},"isPaid":{"type":"boolean"},"publishTime":{"type":"string","format":"date-time"},"expireTime":{"type":"string","format":"date-time"}}},"ResponsePageVoListPostVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/PageVoListPostVo","description":"响应的具体数据"}}},"ResponsePostVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/PostVo","description":"响应的具体数据"}}},"OrderTipVo":{"type":"object","description":"打赏订单视图","properties":{"id":{"type":"string"},"userId":{"type":"string"},"postId":{"type":"string"},"postTitle":{"type":"string"},"expertId":{"type":"string"},"expertName":{"type":"string"},"amount":{"type":"number"},"status":{"type":"string"},"createTime":{"type":"string","format":"date-time"}}},"PageVoListOrderTipVo":{"type":"object","description":"分页数据对象","properties":{"total":{"type":"integer","format":"int64","description":"总数据条数"},"data":{"type":"array","description":"当前页的数据","items":{"$ref":"#/components/schemas/OrderTipVo"}}}},"ResponsePageVoListOrderTipVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"$ref":"#/components/schemas/PageVoListOrderTipVo","description":"响应的具体数据"}}},"NotificationVo":{"type":"object","description":"通知视图","properties":{"id":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"content":{"type":"string"},"isRead":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"ResponseListNotificationVo":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"array","description":"响应的具体数据","items":{"$ref":"#/components/schemas/NotificationVo"}}}},"ResponseMapStringLong":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"type":"object","additionalProperties":{"type":"integer","format":"int64"},"description":"响应的具体数据"}}},"ResponseObject":{"type":"object","description":"后端统一的响应实体","properties":{"code":{"type":"integer","format":"int32","description":"状态码;200:成功"},"message":{"type":"string","description":"响应附加信息"},"data":{"description":"响应的具体数据"}}}}}}
|
