{ "openapi": "3.0.4", "info": { "title": "博客前端接口", "version": "1.0.0" }, "paths": { "/api/albums": { "get": { "tags": [ "albums" ], "summary": "相册列表", "operationId": "api-albums-Get", "parameters": [ { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_AlbumsOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_AlbumsOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_AlbumsOutput" } } } } } } }, "/api/albums/pictures": { "get": { "tags": [ "albums" ], "summary": "相册下的图片", "operationId": "api-albums-pictures-Get", "parameters": [ { "name": "AlbumId", "in": "query", "description": "相册ID", "schema": { "type": "integer", "format": "int64" } }, { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_PictureOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_PictureOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_PictureOutput" } } } } } } }, "/api/app/info": { "get": { "tags": [ "app" ], "summary": "博客基本信息", "operationId": "api-app-info-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_BlogOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_BlogOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_BlogOutput" } } } } } } }, "/api/app/links": { "get": { "tags": [ "app" ], "summary": "友情链接", "operationId": "api-app-links-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_FriendLinkOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_FriendLinkOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_FriendLinkOutput" } } } } } } }, "/api/article": { "get": { "tags": [ "article" ], "summary": "文章表查询", "operationId": "api-article-Get", "parameters": [ { "name": "TagId", "in": "query", "description": "标签ID", "schema": { "type": "integer", "format": "int64" } }, { "name": "CategoryId", "in": "query", "description": "栏目ID", "schema": { "type": "integer", "format": "int64" } }, { "name": "Keyword", "in": "query", "description": "关键词", "schema": { "type": "string" } }, { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ArticleOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ArticleOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ArticleOutput" } } } } } } }, "/api/article/tags": { "get": { "tags": [ "article" ], "summary": "标签列表", "operationId": "api-article-tags-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_TagsOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_TagsOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_TagsOutput" } } } } } } }, "/api/article/categories": { "get": { "tags": [ "article" ], "summary": "文章栏目分类", "operationId": "api-article-categories-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_CategoryOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_CategoryOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_CategoryOutput" } } } } } } }, "/api/article/report": { "get": { "tags": [ "article" ], "summary": "文章信息统计", "operationId": "api-article-report-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleReportOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleReportOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleReportOutput" } } } } } } }, "/api/article/info": { "get": { "tags": [ "article" ], "summary": "文章详情", "operationId": "api-article-info-Get", "parameters": [ { "name": "id", "in": "query", "description": "文章ID", "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleInfoOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleInfoOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_ArticleInfoOutput" } } } } } } }, "/api/article/latest": { "get": { "tags": [ "article" ], "summary": "最新文章", "operationId": "api-article-latest-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_ArticleBasicsOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_ArticleBasicsOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_List_ArticleBasicsOutput" } } } } } } }, "/api/comment": { "get": { "tags": [ "comment" ], "summary": "评论列表", "operationId": "api-comment-Get", "parameters": [ { "name": "Id", "in": "query", "description": "对应模块ID或评论ID（null表留言，0代表友链的评论）", "schema": { "type": "integer", "format": "int64" } }, { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_CommentOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_CommentOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_CommentOutput" } } } } } }, "post": { "tags": [ "comment" ], "summary": "评论、回复", "operationId": "api-comment-Post", "requestBody": { "description": "", "content": { "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/AddCommentInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AddCommentInput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AddCommentInput" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/AddCommentInput" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/AddCommentInput" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/comment/replylist": { "get": { "tags": [ "comment" ], "summary": "回复分页", "operationId": "api-comment-replylist-Get", "parameters": [ { "name": "Id", "in": "query", "description": "对应模块ID或评论ID（null表留言，0代表友链的评论）", "schema": { "type": "integer", "format": "int64" } }, { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ReplyOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ReplyOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_ReplyOutput" } } } } } } }, "/api/comment/delete": { "delete": { "tags": [ "comment" ], "summary": "删除留言", "operationId": "api-comment-delete-Delete", "requestBody": { "description": "", "content": { "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/KeyDto" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/comment/praise": { "post": { "tags": [ "comment" ], "summary": "点赞/取消点赞", "operationId": "api-comment-praise-Post", "requestBody": { "description": "对象ID", "content": { "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/KeyDto" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/KeyDto" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_Boolean" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_Boolean" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_Boolean" } } } } } } }, "/api/oauth/{type}": { "get": { "tags": [ "oauth" ], "summary": "获取授权地址", "operationId": "api-oauth-type-Get", "parameters": [ { "name": "type", "in": "path", "description": "授权登录类型", "required": true, "schema": { "type": "string" } }, { "name": "referer", "in": "query", "description": "回跳地址", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } } } } } } }, "/api/oauth/{type}/callback": { "get": { "tags": [ "oauth" ], "summary": "授权回调", "operationId": "api-oauth-type-callback-Get", "parameters": [ { "name": "type", "in": "path", "description": "授权类型", "required": true, "schema": { "type": "string" } }, { "name": "code", "in": "query", "description": "", "schema": { "type": "string" } }, { "name": "state", "in": "query", "description": "缓存唯一ID", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_IActionResult" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_IActionResult" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_IActionResult" } } } } } } }, "/api/oauth/login/{code}": { "post": { "tags": [ "oauth" ], "summary": "登录", "operationId": "api-oauth-login-code-Post", "parameters": [ { "name": "code", "in": "path", "description": "", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_String" } } } } } } }, "/api/oauth/userinfo": { "get": { "tags": [ "oauth" ], "summary": "获取用户信息", "operationId": "api-oauth-userinfo-Get", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_OAuthAccountDetailOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_OAuthAccountDetailOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_OAuthAccountDetailOutput" } } } } } } }, "/api/oauth/link": { "post": { "tags": [ "oauth" ], "summary": "申请友链", "operationId": "api-oauth-link-Post", "requestBody": { "description": "", "content": { "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/AddLinkOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AddLinkOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AddLinkOutput" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/AddLinkOutput" } }, "text/plain": { "schema": { "$ref": "#/components/schemas/AddLinkOutput" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/talks": { "get": { "tags": [ "talks" ], "summary": "说说列表", "operationId": "api-talks-Get", "parameters": [ { "name": "PageNo", "in": "query", "description": "当前页码", "schema": { "type": "integer", "format": "int32" } }, { "name": "PageSize", "in": "query", "description": "页码容量", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_TalksOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_TalksOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_PageResult_TalksOutput" } } } } } } }, "/api/talks/talkdetail": { "get": { "tags": [ "talks" ], "summary": "说说详情", "operationId": "api-talks-talkdetail-Get", "parameters": [ { "name": "id", "in": "query", "description": "", "schema": { "type": "integer", "format": "int64" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RESTfulResult_TalkDetailOutput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_TalkDetailOutput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RESTfulResult_TalkDetailOutput" } } } } } } } }, "components": { "schemas": { "AddCommentInput": { "required": [ "content" ], "type": "object", "properties": { "moduleId": { "type": "integer", "description": "对应模块ID（null表留言，0代表友链的评论）", "format": "int64", "nullable": true }, "rootId": { "type": "integer", "description": "顶级楼层评论ID", "format": "int64", "nullable": true }, "parentId": { "type": "integer", "description": "被回复的评论ID", "format": "int64", "nullable": true }, "replyAccountId": { "type": "integer", "description": "回复人ID", "format": "int64", "nullable": true }, "content": { "maxLength": 600, "minLength": 1, "type": "string", "description": "评论内容" } }, "additionalProperties": false }, "AddLinkOutput": { "required": [ "link", "logo", "remark", "siteName", "url" ], "type": "object", "properties": { "siteName": { "maxLength": 32, "minLength": 1, "type": "string", "description": "网站名称" }, "link": { "maxLength": 256, "minLength": 1, "type": "string", "description": "网站链接" }, "logo": { "maxLength": 256, "minLength": 1, "type": "string", "description": "网站logo" }, "url": { "maxLength": 256, "minLength": 1, "type": "string", "description": "对方博客友链的地址" }, "remark": { "maxLength": 200, "minLength": 1, "type": "string", "description": "网站介绍" } }, "additionalProperties": false }, "AlbumsOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "相册ID", "format": "int64" }, "name": { "type": "string", "description": "相册名称", "nullable": true }, "cover": { "type": "string", "description": "相册封面", "nullable": true }, "remark": { "type": "string", "description": "相册描述", "nullable": true }, "createdTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "additionalProperties": false }, "ArticleBasicsOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "文章ID", "format": "int64" }, "cover": { "type": "string", "description": "封面图", "nullable": true }, "type": { "type": "integer", "description": "类型", "format": "int32" }, "title": { "type": "string", "description": "标题", "nullable": true }, "publishTime": { "type": "string", "description": "发布时间", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "ArticleInfoOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "文章ID", "format": "int64" }, "title": { "type": "string", "description": "标题", "nullable": true }, "content": { "type": "string", "description": "文章内容", "nullable": true }, "summary": { "type": "string", "description": "简介", "nullable": true }, "cover": { "type": "string", "description": "封面图", "nullable": true }, "publishTime": { "type": "string", "description": "发布时间", "format": "date-time" }, "author": { "type": "string", "description": "作者", "nullable": true }, "views": { "type": "integer", "description": "浏览量", "format": "int32" }, "creationType": { "$ref": "#/components/schemas/CreationType" }, "isAllowComments": { "type": "boolean", "description": "是否允许评论" }, "isHtml": { "type": "boolean", "description": "是否是html" }, "isTop": { "type": "boolean", "description": "是否置顶" }, "link": { "type": "string", "description": "转载链接", "nullable": true }, "praiseTotal": { "type": "integer", "description": "点赞数量", "format": "int32" }, "isPraise": { "type": "boolean", "description": "当前用户是否已点赞" }, "categoryId": { "type": "integer", "description": "栏目Id", "format": "int64" }, "categoryName": { "type": "string", "description": "栏目名称", "nullable": true }, "updatedTime": { "type": "string", "description": "最后更新时间", "format": "date-time", "nullable": true }, "prev": { "$ref": "#/components/schemas/ArticleBasicsOutput" }, "next": { "$ref": "#/components/schemas/ArticleBasicsOutput" }, "random": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleBasicsOutput" }, "description": "随机", "nullable": true }, "tags": { "type": "array", "items": { "$ref": "#/components/schemas/TagsOutput" }, "description": "标签", "nullable": true } }, "additionalProperties": false }, "ArticleOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "文章ID", "format": "int64" }, "title": { "type": "string", "description": "标题", "nullable": true }, "categoryId": { "type": "integer", "description": "栏目ID", "format": "int64" }, "categoryName": { "type": "string", "description": "栏目名称", "nullable": true }, "isTop": { "type": "boolean", "description": "是否置顶" }, "creationType": { "$ref": "#/components/schemas/CreationType" }, "summary": { "type": "string", "description": "简介", "nullable": true }, "cover": { "type": "string", "description": "封面图", "nullable": true }, "publishTime": { "type": "string", "description": "发布时间", "format": "date-time" }, "tags": { "type": "array", "items": { "$ref": "#/components/schemas/TagsOutput" }, "description": "标签", "nullable": true } }, "additionalProperties": false }, "ArticleReportOutput": { "type": "object", "properties": { "articleCount": { "type": "integer", "description": "文章数量", "format": "int32" }, "tagCount": { "type": "integer", "description": "标签数量", "format": "int32" }, "categoryCount": { "type": "integer", "description": "栏目数量", "format": "int32" }, "userCount": { "type": "integer", "description": "用户量", "format": "int32" }, "linkCount": { "type": "integer", "description": "友链数量", "format": "int32" } }, "additionalProperties": false }, "AvailabilityStatus": { "enum": [ "Enable", "Disable" ], "type": "string", "description": "可用状态
 启用 Enable = 0
 禁用 Disable = 1
" }, "BlogOutput": { "type": "object", "properties": { "site": { "$ref": "#/components/schemas/BlogSetting" }, "info": { "$ref": "#/components/schemas/BloggerInfo" }, "covers": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" }, "nullable": true }, "description": "各个页面封面图", "nullable": true } }, "additionalProperties": false }, "BlogSetting": { "type": "object", "properties": { "logo": { "type": "string", "description": "网站Logo", "nullable": true }, "favicon": { "type": "string", "description": "站点图标", "nullable": true }, "isRewards": { "type": "boolean", "description": "开启打赏", "nullable": true }, "aliPay": { "type": "string", "description": "支付宝", "nullable": true }, "wxPay": { "type": "string", "description": "微信收款码", "nullable": true }, "isAllowMessage": { "type": "boolean", "description": "允许留言", "nullable": true }, "isAllowComments": { "type": "boolean", "description": "允许评论", "nullable": true }, "announcement": { "type": "string", "description": "公告", "nullable": true }, "siteName": { "type": "string", "description": "站点名称", "nullable": true }, "motto": { "type": "string", "description": "首页格言", "nullable": true }, "runTime": { "type": "string", "description": "网站运营时间", "format": "date-time" }, "copyright": { "type": "string", "description": "站点版权", "nullable": true }, "description": { "type": "string", "description": "站点描述", "nullable": true }, "keyword": { "type": "string", "description": "关键词", "nullable": true }, "filing": { "type": "string", "description": "备案号", "nullable": true } }, "additionalProperties": false }, "BloggerInfo": { "type": "object", "properties": { "avatar": { "type": "string", "description": "头像", "nullable": true }, "nikeName": { "type": "string", "description": "昵称", "nullable": true }, "qq": { "type": "string", "description": "QQ", "nullable": true }, "github": { "type": "string", "description": "Github", "nullable": true }, "gitee": { "type": "string", "description": "码云", "nullable": true }, "motto": { "type": "string", "description": "个性签名", "nullable": true }, "about": { "type": "string", "description": "关于我", "nullable": true } }, "additionalProperties": false }, "CategoryOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "栏目ID", "format": "int64" }, "parentId": { "type": "integer", "description": "父级ID", "format": "int64", "nullable": true }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "name": { "type": "string", "description": "栏目名称", "nullable": true }, "total": { "type": "integer", "description": "文章条数", "format": "int32" } }, "additionalProperties": false }, "CommentOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "评论ID", "format": "int64" }, "isBlogger": { "type": "boolean", "description": "博主标识" }, "accountId": { "type": "integer", "description": "评论人ID", "format": "int64" }, "nickName": { "type": "string", "description": "昵称", "nullable": true }, "avatar": { "type": "string", "description": "头像", "nullable": true }, "index": { "type": "integer", "description": "楼层", "format": "int32" }, "content": { "type": "string", "description": "评论内容", "nullable": true }, "replyCount": { "type": "integer", "description": "回复条数", "format": "int32" }, "praiseTotal": { "type": "integer", "description": "点赞数量", "format": "int32" }, "isPraise": { "type": "boolean", "description": "是否已点赞" }, "ip": { "type": "string", "description": "Ip地址", "nullable": true }, "geolocation": { "type": "string", "description": "Ip归属地", "nullable": true }, "createdTime": { "type": "string", "description": "评论时间", "format": "date-time" }, "replyList": { "$ref": "#/components/schemas/PageResult_ReplyOutput" } }, "additionalProperties": false }, "CreationType": { "enum": [ "Original", "Reprinted" ], "type": "string", "description": "
 原创 Original = 0
 转载 Reprinted = 1
" }, "FriendLinkOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "友链ID", "format": "int64" }, "link": { "type": "string", "description": "友链", "nullable": true }, "logo": { "type": "string", "description": "logo", "nullable": true }, "siteName": { "type": "string", "description": "站点名称", "nullable": true }, "remark": { "type": "string", "description": "网站描述", "nullable": true } }, "additionalProperties": false }, "IActionResult": { "type": "object", "additionalProperties": false }, "KeyDto": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" } }, "additionalProperties": false }, "OAuthAccountDetailOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "用户ID", "format": "int64" }, "nickName": { "type": "string", "description": "昵称", "nullable": true }, "avatar": { "type": "string", "description": "头像", "nullable": true }, "status": { "$ref": "#/components/schemas/AvailabilityStatus" }, "link": { "type": "string", "description": "网站链接", "nullable": true }, "logo": { "type": "string", "description": "logo", "nullable": true }, "siteName": { "type": "string", "description": "网站名称", "nullable": true }, "url": { "type": "string", "description": "对方博客友链地址", "nullable": true }, "remark": { "type": "string", "description": "网站介绍", "nullable": true } }, "additionalProperties": false }, "PageResult_AlbumsOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/AlbumsOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PageResult_ArticleOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PageResult_CommentOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/CommentOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PageResult_PictureOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/PictureOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PageResult_ReplyOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ReplyOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PageResult_TalksOutput": { "type": "object", "properties": { "pageNo": { "type": "integer", "description": "当前页", "format": "int32" }, "pageSize": { "type": "integer", "description": "页容量", "format": "int32" }, "pages": { "type": "integer", "description": "总页数", "format": "int32" }, "total": { "type": "integer", "description": "总条数", "format": "int32" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/TalksOutput" }, "description": "数据", "nullable": true } }, "additionalProperties": false }, "PictureOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "图片ID", "format": "int64" }, "url": { "type": "string", "description": "图片地址", "nullable": true } }, "additionalProperties": false }, "RESTfulResult_ArticleInfoOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/ArticleInfoOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_ArticleReportOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/ArticleReportOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_BlogOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/BlogOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_Boolean": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "boolean" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_IActionResult": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/IActionResult" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_List_ArticleBasicsOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleBasicsOutput" }, "nullable": true }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_List_CategoryOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryOutput" }, "nullable": true }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_List_FriendLinkOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/FriendLinkOutput" }, "nullable": true }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_List_TagsOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TagsOutput" }, "nullable": true }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_OAuthAccountDetailOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/OAuthAccountDetailOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_AlbumsOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_AlbumsOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_ArticleOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_ArticleOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_CommentOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_CommentOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_PictureOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_PictureOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_ReplyOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_ReplyOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_PageResult_TalksOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/PageResult_TalksOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_String": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "type": "string", "nullable": true }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "RESTfulResult_TalkDetailOutput": { "type": "object", "properties": { "statusCode": { "type": "integer", "format": "int32", "nullable": true }, "data": { "$ref": "#/components/schemas/TalkDetailOutput" }, "succeeded": { "type": "boolean" }, "errors": { "additionalProperties": false, "nullable": true }, "extras": { "additionalProperties": false, "nullable": true }, "timestamp": { "type": "integer", "format": "int64" } }, "additionalProperties": false }, "ReplyOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "评论ID", "format": "int64" }, "content": { "type": "string", "description": "评论内容", "nullable": true }, "isBlogger": { "type": "boolean", "description": "博主标识" }, "rootId": { "type": "integer", "description": "顶级楼层评论ID", "format": "int64", "nullable": true }, "parentId": { "type": "integer", "description": "上级评论ID", "format": "int64", "nullable": true }, "accountId": { "type": "integer", "description": "当前评论人ID", "format": "int64" }, "replyAccountId": { "type": "integer", "description": "回复人ID", "format": "int64", "nullable": true }, "nickName": { "type": "string", "description": "当前人昵称", "nullable": true }, "relyNickName": { "type": "string", "description": "回复人昵称", "nullable": true }, "avatar": { "type": "string", "description": "当前评论人头像", "nullable": true }, "ip": { "type": "string", "description": "Ip地址", "nullable": true }, "praiseTotal": { "type": "integer", "description": "点赞数量", "format": "int32" }, "isPraise": { "type": "boolean", "description": "是否已点赞" }, "geolocation": { "type": "string", "description": "Ip所属地", "nullable": true }, "createdTime": { "type": "string", "description": "评论时间", "format": "date-time" } }, "additionalProperties": false }, "TagsOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "标签ID", "format": "int64" }, "icon": { "type": "string", "description": "图标", "nullable": true }, "name": { "type": "string", "description": "标签名称", "nullable": true }, "color": { "type": "string", "description": "颜色", "nullable": true } }, "additionalProperties": false }, "TalkDetailOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "", "format": "int64" }, "isTop": { "type": "boolean", "description": "是否置顶" }, "content": { "type": "string", "description": "内容", "nullable": true }, "images": { "type": "string", "description": "图片", "nullable": true }, "isPraise": { "type": "boolean", "description": "是否已点赞" }, "upvote": { "type": "integer", "description": "点赞数量", "format": "int32" }, "comments": { "type": "integer", "description": "评论数量", "format": "int32" }, "createdTime": { "type": "string", "description": "发布时间", "format": "date-time" }, "isAllowComments": { "type": "boolean", "description": "是否允许评论" } }, "additionalProperties": false }, "TalksOutput": { "type": "object", "properties": { "id": { "type": "integer", "description": "", "format": "int64" }, "isTop": { "type": "boolean", "description": "是否置顶" }, "content": { "type": "string", "description": "内容", "nullable": true }, "images": { "type": "string", "description": "图片", "nullable": true }, "isPraise": { "type": "boolean", "description": "是否已点赞" }, "upvote": { "type": "integer", "description": "点赞数量", "format": "int32" }, "comments": { "type": "integer", "description": "评论数量", "format": "int32" }, "createdTime": { "type": "string", "description": "发布时间", "format": "date-time" } }, "additionalProperties": false } }, "securitySchemes": { "Bearer": { "type": "http", "description": "JWT Authorization header using the Bearer scheme.", "scheme": "bearer", "bearerFormat": "JWT" } } }, "security": [ { "Bearer": [ ] } ], "tags": [ { "name": "albums", "description": "相册" }, { "name": "app", "description": "博客基本信息" }, { "name": "article", "description": "博客文章" }, { "name": "comment", "description": "评论" }, { "name": "oauth", "description": "第三方授权登录" }, { "name": "talks", "description": "博客说说" } ] }