This is an automated email from the ASF dual-hosted git repository.
kumfo pushed a commit to branch feat/1.8.0/menu
in repository https://gitbox.apache.org/repos/asf/answer.git
The following commit(s) were added to refs/heads/feat/1.8.0/menu by this push:
new 3cd3e4a8 feat(menu): update admin menu settings to include questions,
tags, and advanced options
3cd3e4a8 is described below
commit 3cd3e4a888dca7829b3489efc7cf844e8f0403e5
Author: kumfo <[email protected]>
AuthorDate: Tue Jan 20 15:32:45 2026 +0800
feat(menu): update admin menu settings to include questions, tags, and
advanced options
---
docs/docs.go | 457 ++++++++++++++++++++++++++++++++++++------------------
docs/swagger.json | 438 +++++++++++++++++++++++++++++++++++----------------
docs/swagger.yaml | 315 +++++++++++++++++++++++--------------
3 files changed, 804 insertions(+), 406 deletions(-)
diff --git a/docs/docs.go b/docs/docs.go
index 5e9d5b39..73d85436 100644
--- a/docs/docs.go
+++ b/docs/docs.go
@@ -1,22 +1,3 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied. See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
// Package docs Code generated by swaggo/swag. DO NOT EDIT
package docs
@@ -875,6 +856,77 @@ const docTemplate = `{
}
}
},
+ "/answer/admin/api/siteinfo/advanced": {
+ "get": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "get site advanced setting",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "get site advanced setting",
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/handler.RespBody"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "data": {
+ "$ref":
"#/definitions/schema.SiteAdvancedResp"
+ }
+ }
+ }
+ ]
+ }
+ }
+ }
+ },
+ "put": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "update site advanced info",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "update site advanced info",
+ "parameters": [
+ {
+ "description": "advanced settings",
+ "name": "data",
+ "in": "body",
+ "required": true,
+ "schema": {
+ "$ref": "#/definitions/schema.SiteAdvancedReq"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "#/definitions/handler.RespBody"
+ }
+ }
+ }
+ }
+ },
"/answer/admin/api/siteinfo/branding": {
"get": {
"security": [
@@ -1301,6 +1353,77 @@ const docTemplate = `{
}
}
},
+ "/answer/admin/api/siteinfo/question": {
+ "get": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "get site questions setting",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "get site questions setting",
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/handler.RespBody"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "data": {
+ "$ref":
"#/definitions/schema.SiteQuestionsResp"
+ }
+ }
+ }
+ ]
+ }
+ }
+ }
+ },
+ "put": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "update site question settings",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "update site question settings",
+ "parameters": [
+ {
+ "description": "questions settings",
+ "name": "data",
+ "in": "body",
+ "required": true,
+ "schema": {
+ "$ref": "#/definitions/schema.SiteQuestionsReq"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "#/definitions/handler.RespBody"
+ }
+ }
+ }
+ }
+ },
"/answer/admin/api/siteinfo/seo": {
"get": {
"security": [
@@ -1372,21 +1495,21 @@ const docTemplate = `{
}
}
},
- "/answer/admin/api/siteinfo/theme": {
+ "/answer/admin/api/siteinfo/tag": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site info theme config",
+ "description": "get site tags setting",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site info theme config",
+ "summary": "get site tags setting",
"responses": {
"200": {
"description": "OK",
@@ -1399,7 +1522,7 @@ const docTemplate = `{
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteThemeResp"
+ "$ref":
"#/definitions/schema.SiteTagsResp"
}
}
}
@@ -1414,22 +1537,22 @@ const docTemplate = `{
"ApiKeyAuth": []
}
],
- "description": "update site custom css html config",
+ "description": "update site tag settings",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site custom css html config",
+ "summary": "update site tag settings",
"parameters": [
{
- "description": "login info",
+ "description": "tags settings",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteThemeReq"
+ "$ref": "#/definitions/schema.SiteTagsReq"
}
}
],
@@ -1443,21 +1566,21 @@ const docTemplate = `{
}
}
},
- "/answer/admin/api/siteinfo/users": {
+ "/answer/admin/api/siteinfo/theme": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site user config",
+ "description": "get site info theme config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site user config",
+ "summary": "get site info theme config",
"responses": {
"200": {
"description": "OK",
@@ -1470,7 +1593,7 @@ const docTemplate = `{
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteUsersResp"
+ "$ref":
"#/definitions/schema.SiteThemeResp"
}
}
}
@@ -1485,22 +1608,22 @@ const docTemplate = `{
"ApiKeyAuth": []
}
],
- "description": "update site info config about users",
+ "description": "update site custom css html config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site info config about users",
+ "summary": "update site custom css html config",
"parameters": [
{
- "description": "users info",
+ "description": "login info",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteUsersReq"
+ "$ref": "#/definitions/schema.SiteThemeReq"
}
}
],
@@ -1514,21 +1637,21 @@ const docTemplate = `{
}
}
},
- "/answer/admin/api/siteinfo/write": {
+ "/answer/admin/api/siteinfo/users": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site interface",
+ "description": "get site user config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site interface",
+ "summary": "get site user config",
"responses": {
"200": {
"description": "OK",
@@ -1541,7 +1664,7 @@ const docTemplate = `{
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteWriteResp"
+ "$ref":
"#/definitions/schema.SiteUsersResp"
}
}
}
@@ -1556,22 +1679,22 @@ const docTemplate = `{
"ApiKeyAuth": []
}
],
- "description": "update site write info",
+ "description": "update site info config about users",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site write info",
+ "summary": "update site info config about users",
"parameters": [
{
- "description": "write info",
+ "description": "users info",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteWriteReq"
+ "$ref": "#/definitions/schema.SiteUsersReq"
}
}
],
@@ -10497,6 +10620,58 @@ const docTemplate = `{
}
}
},
+ "schema.SiteAdvancedReq": {
+ "type": "object",
+ "properties": {
+ "authorized_attachment_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "authorized_image_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "max_attachment_size": {
+ "type": "integer"
+ },
+ "max_image_megapixel": {
+ "type": "integer"
+ },
+ "max_image_size": {
+ "type": "integer"
+ }
+ }
+ },
+ "schema.SiteAdvancedResp": {
+ "type": "object",
+ "properties": {
+ "authorized_attachment_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "authorized_image_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "max_attachment_size": {
+ "type": "integer"
+ },
+ "max_image_megapixel": {
+ "type": "integer"
+ },
+ "max_image_size": {
+ "type": "integer"
+ }
+ }
+ },
"schema.SiteBrandingReq": {
"type": "object",
"properties": {
@@ -10676,18 +10851,24 @@ const docTemplate = `{
"revision": {
"type": "string"
},
+ "site_advanced": {
+ "$ref": "#/definitions/schema.SiteAdvancedResp"
+ },
"site_legal": {
"$ref": "#/definitions/schema.SiteLegalSimpleResp"
},
+ "site_questions": {
+ "$ref": "#/definitions/schema.SiteQuestionsResp"
+ },
"site_seo": {
"$ref": "#/definitions/schema.SiteSeoResp"
},
+ "site_tags": {
+ "$ref": "#/definitions/schema.SiteTagsResp"
+ },
"site_users": {
"$ref": "#/definitions/schema.SiteUsersResp"
},
- "site_write": {
- "$ref": "#/definitions/schema.SiteWriteResp"
- },
"theme": {
"$ref": "#/definitions/schema.SiteThemeResp"
},
@@ -10867,6 +11048,32 @@ const docTemplate = `{
}
}
},
+ "schema.SiteQuestionsReq": {
+ "type": "object",
+ "properties": {
+ "min_content": {
+ "type": "integer",
+ "maximum": 65535,
+ "minimum": 0
+ },
+ "restrict_answer": {
+ "type": "boolean"
+ }
+ }
+ },
+ "schema.SiteQuestionsResp": {
+ "type": "object",
+ "properties": {
+ "min_content": {
+ "type": "integer",
+ "maximum": 65535,
+ "minimum": 0
+ },
+ "restrict_answer": {
+ "type": "boolean"
+ }
+ }
+ },
"schema.SiteSeoReq": {
"type": "object",
"required": [
@@ -10901,6 +11108,56 @@ const docTemplate = `{
}
}
},
+ "schema.SiteTagsReq": {
+ "type": "object",
+ "properties": {
+ "min_tags": {
+ "type": "integer",
+ "maximum": 5,
+ "minimum": 0
+ },
+ "recommend_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ },
+ "required_tag": {
+ "type": "boolean"
+ },
+ "reserved_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ }
+ }
+ },
+ "schema.SiteTagsResp": {
+ "type": "object",
+ "properties": {
+ "min_tags": {
+ "type": "integer",
+ "maximum": 5,
+ "minimum": 0
+ },
+ "recommend_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ },
+ "required_tag": {
+ "type": "boolean"
+ },
+ "reserved_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ }
+ }
+ },
"schema.SiteThemeReq": {
"type": "object",
"required": [
@@ -11014,114 +11271,6 @@ const docTemplate = `{
}
}
},
- "schema.SiteWriteReq": {
- "type": "object",
- "properties": {
- "authorized_attachment_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "authorized_image_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "max_attachment_size": {
- "type": "integer"
- },
- "max_image_megapixel": {
- "type": "integer"
- },
- "max_image_size": {
- "type": "integer"
- },
- "min_content": {
- "type": "integer",
- "maximum": 65535,
- "minimum": 0
- },
- "min_tags": {
- "type": "integer",
- "maximum": 5,
- "minimum": 0
- },
- "recommend_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "required_tag": {
- "type": "boolean"
- },
- "reserved_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "restrict_answer": {
- "type": "boolean"
- }
- }
- },
- "schema.SiteWriteResp": {
- "type": "object",
- "properties": {
- "authorized_attachment_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "authorized_image_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "max_attachment_size": {
- "type": "integer"
- },
- "max_image_megapixel": {
- "type": "integer"
- },
- "max_image_size": {
- "type": "integer"
- },
- "min_content": {
- "type": "integer",
- "maximum": 65535,
- "minimum": 0
- },
- "min_tags": {
- "type": "integer",
- "maximum": 5,
- "minimum": 0
- },
- "recommend_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "required_tag": {
- "type": "boolean"
- },
- "reserved_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "restrict_answer": {
- "type": "boolean"
- }
- }
- },
"schema.SiteWriteTag": {
"type": "object",
"required": [
diff --git a/docs/swagger.json b/docs/swagger.json
index e0f6378e..6dbecc50 100644
--- a/docs/swagger.json
+++ b/docs/swagger.json
@@ -848,6 +848,77 @@
}
}
},
+ "/answer/admin/api/siteinfo/advanced": {
+ "get": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "get site advanced setting",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "get site advanced setting",
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/handler.RespBody"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "data": {
+ "$ref":
"#/definitions/schema.SiteAdvancedResp"
+ }
+ }
+ }
+ ]
+ }
+ }
+ }
+ },
+ "put": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "update site advanced info",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "update site advanced info",
+ "parameters": [
+ {
+ "description": "advanced settings",
+ "name": "data",
+ "in": "body",
+ "required": true,
+ "schema": {
+ "$ref": "#/definitions/schema.SiteAdvancedReq"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "#/definitions/handler.RespBody"
+ }
+ }
+ }
+ }
+ },
"/answer/admin/api/siteinfo/branding": {
"get": {
"security": [
@@ -1274,6 +1345,77 @@
}
}
},
+ "/answer/admin/api/siteinfo/question": {
+ "get": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "get site questions setting",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "get site questions setting",
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/handler.RespBody"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "data": {
+ "$ref":
"#/definitions/schema.SiteQuestionsResp"
+ }
+ }
+ }
+ ]
+ }
+ }
+ }
+ },
+ "put": {
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "update site question settings",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "admin"
+ ],
+ "summary": "update site question settings",
+ "parameters": [
+ {
+ "description": "questions settings",
+ "name": "data",
+ "in": "body",
+ "required": true,
+ "schema": {
+ "$ref": "#/definitions/schema.SiteQuestionsReq"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "#/definitions/handler.RespBody"
+ }
+ }
+ }
+ }
+ },
"/answer/admin/api/siteinfo/seo": {
"get": {
"security": [
@@ -1345,21 +1487,21 @@
}
}
},
- "/answer/admin/api/siteinfo/theme": {
+ "/answer/admin/api/siteinfo/tag": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site info theme config",
+ "description": "get site tags setting",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site info theme config",
+ "summary": "get site tags setting",
"responses": {
"200": {
"description": "OK",
@@ -1372,7 +1514,7 @@
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteThemeResp"
+ "$ref":
"#/definitions/schema.SiteTagsResp"
}
}
}
@@ -1387,22 +1529,22 @@
"ApiKeyAuth": []
}
],
- "description": "update site custom css html config",
+ "description": "update site tag settings",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site custom css html config",
+ "summary": "update site tag settings",
"parameters": [
{
- "description": "login info",
+ "description": "tags settings",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteThemeReq"
+ "$ref": "#/definitions/schema.SiteTagsReq"
}
}
],
@@ -1416,21 +1558,21 @@
}
}
},
- "/answer/admin/api/siteinfo/users": {
+ "/answer/admin/api/siteinfo/theme": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site user config",
+ "description": "get site info theme config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site user config",
+ "summary": "get site info theme config",
"responses": {
"200": {
"description": "OK",
@@ -1443,7 +1585,7 @@
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteUsersResp"
+ "$ref":
"#/definitions/schema.SiteThemeResp"
}
}
}
@@ -1458,22 +1600,22 @@
"ApiKeyAuth": []
}
],
- "description": "update site info config about users",
+ "description": "update site custom css html config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site info config about users",
+ "summary": "update site custom css html config",
"parameters": [
{
- "description": "users info",
+ "description": "login info",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteUsersReq"
+ "$ref": "#/definitions/schema.SiteThemeReq"
}
}
],
@@ -1487,21 +1629,21 @@
}
}
},
- "/answer/admin/api/siteinfo/write": {
+ "/answer/admin/api/siteinfo/users": {
"get": {
"security": [
{
"ApiKeyAuth": []
}
],
- "description": "get site interface",
+ "description": "get site user config",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "get site interface",
+ "summary": "get site user config",
"responses": {
"200": {
"description": "OK",
@@ -1514,7 +1656,7 @@
"type": "object",
"properties": {
"data": {
- "$ref":
"#/definitions/schema.SiteWriteResp"
+ "$ref":
"#/definitions/schema.SiteUsersResp"
}
}
}
@@ -1529,22 +1671,22 @@
"ApiKeyAuth": []
}
],
- "description": "update site write info",
+ "description": "update site info config about users",
"produces": [
"application/json"
],
"tags": [
"admin"
],
- "summary": "update site write info",
+ "summary": "update site info config about users",
"parameters": [
{
- "description": "write info",
+ "description": "users info",
"name": "data",
"in": "body",
"required": true,
"schema": {
- "$ref": "#/definitions/schema.SiteWriteReq"
+ "$ref": "#/definitions/schema.SiteUsersReq"
}
}
],
@@ -10470,6 +10612,58 @@
}
}
},
+ "schema.SiteAdvancedReq": {
+ "type": "object",
+ "properties": {
+ "authorized_attachment_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "authorized_image_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "max_attachment_size": {
+ "type": "integer"
+ },
+ "max_image_megapixel": {
+ "type": "integer"
+ },
+ "max_image_size": {
+ "type": "integer"
+ }
+ }
+ },
+ "schema.SiteAdvancedResp": {
+ "type": "object",
+ "properties": {
+ "authorized_attachment_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "authorized_image_extensions": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "max_attachment_size": {
+ "type": "integer"
+ },
+ "max_image_megapixel": {
+ "type": "integer"
+ },
+ "max_image_size": {
+ "type": "integer"
+ }
+ }
+ },
"schema.SiteBrandingReq": {
"type": "object",
"properties": {
@@ -10649,18 +10843,24 @@
"revision": {
"type": "string"
},
+ "site_advanced": {
+ "$ref": "#/definitions/schema.SiteAdvancedResp"
+ },
"site_legal": {
"$ref": "#/definitions/schema.SiteLegalSimpleResp"
},
+ "site_questions": {
+ "$ref": "#/definitions/schema.SiteQuestionsResp"
+ },
"site_seo": {
"$ref": "#/definitions/schema.SiteSeoResp"
},
+ "site_tags": {
+ "$ref": "#/definitions/schema.SiteTagsResp"
+ },
"site_users": {
"$ref": "#/definitions/schema.SiteUsersResp"
},
- "site_write": {
- "$ref": "#/definitions/schema.SiteWriteResp"
- },
"theme": {
"$ref": "#/definitions/schema.SiteThemeResp"
},
@@ -10840,6 +11040,32 @@
}
}
},
+ "schema.SiteQuestionsReq": {
+ "type": "object",
+ "properties": {
+ "min_content": {
+ "type": "integer",
+ "maximum": 65535,
+ "minimum": 0
+ },
+ "restrict_answer": {
+ "type": "boolean"
+ }
+ }
+ },
+ "schema.SiteQuestionsResp": {
+ "type": "object",
+ "properties": {
+ "min_content": {
+ "type": "integer",
+ "maximum": 65535,
+ "minimum": 0
+ },
+ "restrict_answer": {
+ "type": "boolean"
+ }
+ }
+ },
"schema.SiteSeoReq": {
"type": "object",
"required": [
@@ -10874,6 +11100,56 @@
}
}
},
+ "schema.SiteTagsReq": {
+ "type": "object",
+ "properties": {
+ "min_tags": {
+ "type": "integer",
+ "maximum": 5,
+ "minimum": 0
+ },
+ "recommend_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ },
+ "required_tag": {
+ "type": "boolean"
+ },
+ "reserved_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ }
+ }
+ },
+ "schema.SiteTagsResp": {
+ "type": "object",
+ "properties": {
+ "min_tags": {
+ "type": "integer",
+ "maximum": 5,
+ "minimum": 0
+ },
+ "recommend_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ },
+ "required_tag": {
+ "type": "boolean"
+ },
+ "reserved_tags": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/schema.SiteWriteTag"
+ }
+ }
+ }
+ },
"schema.SiteThemeReq": {
"type": "object",
"required": [
@@ -10987,114 +11263,6 @@
}
}
},
- "schema.SiteWriteReq": {
- "type": "object",
- "properties": {
- "authorized_attachment_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "authorized_image_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "max_attachment_size": {
- "type": "integer"
- },
- "max_image_megapixel": {
- "type": "integer"
- },
- "max_image_size": {
- "type": "integer"
- },
- "min_content": {
- "type": "integer",
- "maximum": 65535,
- "minimum": 0
- },
- "min_tags": {
- "type": "integer",
- "maximum": 5,
- "minimum": 0
- },
- "recommend_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "required_tag": {
- "type": "boolean"
- },
- "reserved_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "restrict_answer": {
- "type": "boolean"
- }
- }
- },
- "schema.SiteWriteResp": {
- "type": "object",
- "properties": {
- "authorized_attachment_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "authorized_image_extensions": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "max_attachment_size": {
- "type": "integer"
- },
- "max_image_megapixel": {
- "type": "integer"
- },
- "max_image_size": {
- "type": "integer"
- },
- "min_content": {
- "type": "integer",
- "maximum": 65535,
- "minimum": 0
- },
- "min_tags": {
- "type": "integer",
- "maximum": 5,
- "minimum": 0
- },
- "recommend_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "required_tag": {
- "type": "boolean"
- },
- "reserved_tags": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/schema.SiteWriteTag"
- }
- },
- "restrict_answer": {
- "type": "boolean"
- }
- }
- },
"schema.SiteWriteTag": {
"type": "object",
"required": [
diff --git a/docs/swagger.yaml b/docs/swagger.yaml
index e0244083..f4107cd6 100644
--- a/docs/swagger.yaml
+++ b/docs/swagger.yaml
@@ -1,20 +1,3 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements. See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership. The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License. You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied. See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
basePath: /
definitions:
constant.NotificationChannelKey:
@@ -2072,6 +2055,40 @@ definitions:
required:
- user_id
type: object
+ schema.SiteAdvancedReq:
+ properties:
+ authorized_attachment_extensions:
+ items:
+ type: string
+ type: array
+ authorized_image_extensions:
+ items:
+ type: string
+ type: array
+ max_attachment_size:
+ type: integer
+ max_image_megapixel:
+ type: integer
+ max_image_size:
+ type: integer
+ type: object
+ schema.SiteAdvancedResp:
+ properties:
+ authorized_attachment_extensions:
+ items:
+ type: string
+ type: array
+ authorized_image_extensions:
+ items:
+ type: string
+ type: array
+ max_attachment_size:
+ type: integer
+ max_image_megapixel:
+ type: integer
+ max_image_size:
+ type: integer
+ type: object
schema.SiteBrandingReq:
properties:
favicon:
@@ -2200,14 +2217,18 @@ definitions:
$ref: '#/definitions/schema.SiteLoginResp'
revision:
type: string
+ site_advanced:
+ $ref: '#/definitions/schema.SiteAdvancedResp'
site_legal:
$ref: '#/definitions/schema.SiteLegalSimpleResp'
+ site_questions:
+ $ref: '#/definitions/schema.SiteQuestionsResp'
site_seo:
$ref: '#/definitions/schema.SiteSeoResp'
+ site_tags:
+ $ref: '#/definitions/schema.SiteTagsResp'
site_users:
$ref: '#/definitions/schema.SiteUsersResp'
- site_write:
- $ref: '#/definitions/schema.SiteWriteResp'
theme:
$ref: '#/definitions/schema.SiteThemeResp'
version:
@@ -2329,6 +2350,24 @@ definitions:
login_required:
type: boolean
type: object
+ schema.SiteQuestionsReq:
+ properties:
+ min_content:
+ maximum: 65535
+ minimum: 0
+ type: integer
+ restrict_answer:
+ type: boolean
+ type: object
+ schema.SiteQuestionsResp:
+ properties:
+ min_content:
+ maximum: 65535
+ minimum: 0
+ type: integer
+ restrict_answer:
+ type: boolean
+ type: object
schema.SiteSeoReq:
properties:
permalink:
@@ -2353,6 +2392,40 @@ definitions:
- permalink
- robots
type: object
+ schema.SiteTagsReq:
+ properties:
+ min_tags:
+ maximum: 5
+ minimum: 0
+ type: integer
+ recommend_tags:
+ items:
+ $ref: '#/definitions/schema.SiteWriteTag'
+ type: array
+ required_tag:
+ type: boolean
+ reserved_tags:
+ items:
+ $ref: '#/definitions/schema.SiteWriteTag'
+ type: array
+ type: object
+ schema.SiteTagsResp:
+ properties:
+ min_tags:
+ maximum: 5
+ minimum: 0
+ type: integer
+ recommend_tags:
+ items:
+ $ref: '#/definitions/schema.SiteWriteTag'
+ type: array
+ required_tag:
+ type: boolean
+ reserved_tags:
+ items:
+ $ref: '#/definitions/schema.SiteWriteTag'
+ type: array
+ type: object
schema.SiteThemeReq:
properties:
color_scheme:
@@ -2429,80 +2502,6 @@ definitions:
required:
- default_avatar
type: object
- schema.SiteWriteReq:
- properties:
- authorized_attachment_extensions:
- items:
- type: string
- type: array
- authorized_image_extensions:
- items:
- type: string
- type: array
- max_attachment_size:
- type: integer
- max_image_megapixel:
- type: integer
- max_image_size:
- type: integer
- min_content:
- maximum: 65535
- minimum: 0
- type: integer
- min_tags:
- maximum: 5
- minimum: 0
- type: integer
- recommend_tags:
- items:
- $ref: '#/definitions/schema.SiteWriteTag'
- type: array
- required_tag:
- type: boolean
- reserved_tags:
- items:
- $ref: '#/definitions/schema.SiteWriteTag'
- type: array
- restrict_answer:
- type: boolean
- type: object
- schema.SiteWriteResp:
- properties:
- authorized_attachment_extensions:
- items:
- type: string
- type: array
- authorized_image_extensions:
- items:
- type: string
- type: array
- max_attachment_size:
- type: integer
- max_image_megapixel:
- type: integer
- max_image_size:
- type: integer
- min_content:
- maximum: 65535
- minimum: 0
- type: integer
- min_tags:
- maximum: 5
- minimum: 0
- type: integer
- recommend_tags:
- items:
- $ref: '#/definitions/schema.SiteWriteTag'
- type: array
- required_tag:
- type: boolean
- reserved_tags:
- items:
- $ref: '#/definitions/schema.SiteWriteTag'
- type: array
- restrict_answer:
- type: boolean
- type: object
schema.SiteWriteTag:
properties:
display_name:
@@ -3702,6 +3701,47 @@ paths:
summary: update smtp config
tags:
- admin
+ /answer/admin/api/siteinfo/advanced:
+ get:
+ description: get site advanced setting
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: OK
+ schema:
+ allOf:
+ - $ref: '#/definitions/handler.RespBody'
+ - properties:
+ data:
+ $ref: '#/definitions/schema.SiteAdvancedResp'
+ type: object
+ security:
+ - ApiKeyAuth: []
+ summary: get site advanced setting
+ tags:
+ - admin
+ put:
+ description: update site advanced info
+ parameters:
+ - description: advanced settings
+ in: body
+ name: data
+ required: true
+ schema:
+ $ref: '#/definitions/schema.SiteAdvancedReq'
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: OK
+ schema:
+ $ref: '#/definitions/handler.RespBody'
+ security:
+ - ApiKeyAuth: []
+ summary: update site advanced info
+ tags:
+ - admin
/answer/admin/api/siteinfo/branding:
get:
description: get site interface
@@ -3948,6 +3988,47 @@ paths:
summary: update site login
tags:
- admin
+ /answer/admin/api/siteinfo/question:
+ get:
+ description: get site questions setting
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: OK
+ schema:
+ allOf:
+ - $ref: '#/definitions/handler.RespBody'
+ - properties:
+ data:
+ $ref: '#/definitions/schema.SiteQuestionsResp'
+ type: object
+ security:
+ - ApiKeyAuth: []
+ summary: get site questions setting
+ tags:
+ - admin
+ put:
+ description: update site question settings
+ parameters:
+ - description: questions settings
+ in: body
+ name: data
+ required: true
+ schema:
+ $ref: '#/definitions/schema.SiteQuestionsReq'
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: OK
+ schema:
+ $ref: '#/definitions/handler.RespBody'
+ security:
+ - ApiKeyAuth: []
+ summary: update site question settings
+ tags:
+ - admin
/answer/admin/api/siteinfo/seo:
get:
description: get site seo information
@@ -3989,9 +4070,9 @@ paths:
summary: update site seo information
tags:
- admin
- /answer/admin/api/siteinfo/theme:
+ /answer/admin/api/siteinfo/tag:
get:
- description: get site info theme config
+ description: get site tags setting
produces:
- application/json
responses:
@@ -4002,22 +4083,22 @@ paths:
- $ref: '#/definitions/handler.RespBody'
- properties:
data:
- $ref: '#/definitions/schema.SiteThemeResp'
+ $ref: '#/definitions/schema.SiteTagsResp'
type: object
security:
- ApiKeyAuth: []
- summary: get site info theme config
+ summary: get site tags setting
tags:
- admin
put:
- description: update site custom css html config
+ description: update site tag settings
parameters:
- - description: login info
+ - description: tags settings
in: body
name: data
required: true
schema:
- $ref: '#/definitions/schema.SiteThemeReq'
+ $ref: '#/definitions/schema.SiteTagsReq'
produces:
- application/json
responses:
@@ -4027,12 +4108,12 @@ paths:
$ref: '#/definitions/handler.RespBody'
security:
- ApiKeyAuth: []
- summary: update site custom css html config
+ summary: update site tag settings
tags:
- admin
- /answer/admin/api/siteinfo/users:
+ /answer/admin/api/siteinfo/theme:
get:
- description: get site user config
+ description: get site info theme config
produces:
- application/json
responses:
@@ -4043,22 +4124,22 @@ paths:
- $ref: '#/definitions/handler.RespBody'
- properties:
data:
- $ref: '#/definitions/schema.SiteUsersResp'
+ $ref: '#/definitions/schema.SiteThemeResp'
type: object
security:
- ApiKeyAuth: []
- summary: get site user config
+ summary: get site info theme config
tags:
- admin
put:
- description: update site info config about users
+ description: update site custom css html config
parameters:
- - description: users info
+ - description: login info
in: body
name: data
required: true
schema:
- $ref: '#/definitions/schema.SiteUsersReq'
+ $ref: '#/definitions/schema.SiteThemeReq'
produces:
- application/json
responses:
@@ -4068,12 +4149,12 @@ paths:
$ref: '#/definitions/handler.RespBody'
security:
- ApiKeyAuth: []
- summary: update site info config about users
+ summary: update site custom css html config
tags:
- admin
- /answer/admin/api/siteinfo/write:
+ /answer/admin/api/siteinfo/users:
get:
- description: get site interface
+ description: get site user config
produces:
- application/json
responses:
@@ -4084,22 +4165,22 @@ paths:
- $ref: '#/definitions/handler.RespBody'
- properties:
data:
- $ref: '#/definitions/schema.SiteWriteResp'
+ $ref: '#/definitions/schema.SiteUsersResp'
type: object
security:
- ApiKeyAuth: []
- summary: get site interface
+ summary: get site user config
tags:
- admin
put:
- description: update site write info
+ description: update site info config about users
parameters:
- - description: write info
+ - description: users info
in: body
name: data
required: true
schema:
- $ref: '#/definitions/schema.SiteWriteReq'
+ $ref: '#/definitions/schema.SiteUsersReq'
produces:
- application/json
responses:
@@ -4109,7 +4190,7 @@ paths:
$ref: '#/definitions/handler.RespBody'
security:
- ApiKeyAuth: []
- summary: update site write info
+ summary: update site info config about users
tags:
- admin
/answer/admin/api/theme/options: