YD_Event.Admin/YD_Event.Web.Entry/obj/Debug/net10.0/EndpointInfo/Easy.Admin.Web.Entry_博客前端接口.json
2025-12-17 10:32:52 +08:00

2719 lines
70 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"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或评论IDnull表留言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或评论IDnull表留言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": "对应模块IDnull表留言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": "可用状态<br />&nbsp;启用 Enable = 0<br />&nbsp;禁用 Disable = 1<br />"
},
"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": "<br />&nbsp;原创 Original = 0<br />&nbsp;转载 Reprinted = 1<br />"
},
"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": "博客说说"
}
]
}