fix: Update swagger docs (#8002)

Refs #8001
This commit is contained in:
2025-02-26 10:55:40 +08:00 committed by GitHub
parent 67c1bf2924
commit 193b0f3cd4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 31 additions and 7 deletions

View file

@ -391,7 +391,7 @@ func (b *BaseApi) ContainerOperation(c *gin.Context) {
// @Tags Container // @Tags Container
// @Summary Container stats // @Summary Container stats
// @Param id path integer true "container id" // @Param id path string true "container id"
// @Success 200 {object} dto.ContainerStats // @Success 200 {object} dto.ContainerStats
// @Security ApiKeyAuth // @Security ApiKeyAuth
// @Security Timestamp // @Security Timestamp

View file

@ -3483,7 +3483,7 @@ const docTemplate = `{
"summary": "Container stats", "summary": "Container stats",
"parameters": [ "parameters": [
{ {
"type": "integer", "type": "string",
"description": "container id", "description": "container id",
"name": "id", "name": "id",
"in": "path", "in": "path",
@ -19382,6 +19382,9 @@ const docTemplate = `{
"dto.ForwardRuleOperate": { "dto.ForwardRuleOperate": {
"type": "object", "type": "object",
"properties": { "properties": {
"forceDelete": {
"type": "boolean"
},
"rules": { "rules": {
"type": "array", "type": "array",
"items": { "items": {
@ -20708,6 +20711,9 @@ const docTemplate = `{
"dto.OllamaBindDomainRes": { "dto.OllamaBindDomainRes": {
"type": "object", "type": "object",
"properties": { "properties": {
"acmeAccountID": {
"type": "integer"
},
"allowIPs": { "allowIPs": {
"type": "array", "type": "array",
"items": { "items": {
@ -26721,7 +26727,7 @@ const docTemplate = `{
}, },
"securityDefinitions": { "securityDefinitions": {
"ApiKeyAuth": { "ApiKeyAuth": {
"description": "- ` + "`" + `1Panel-Token` + "`" + ` is the key for the panel API Key.", "description": "Custom Token Format, Format: md5('1panel' + API-Key + UnixTimestamp).\n` + "`" + `` + "`" + `` + "`" + `\neg:\ncurl -X GET \"http://localhost:4004/api/v1/dashboard/current\" \\\n-H \"1Panel-Token: \u003c1panel_token\u003e\" \\\n-H \"1Panel-Timestamp: \u003ccurrent_unix_timestamp\u003e\"\n` + "`" + `` + "`" + `` + "`" + `\n- ` + "`" + `1Panel-Token` + "`" + ` is the key for the panel API Key.",
"type": "apiKey", "type": "apiKey",
"name": "1Panel-Token", "name": "1Panel-Token",
"in": "header" "in": "header"

View file

@ -3480,7 +3480,7 @@
"summary": "Container stats", "summary": "Container stats",
"parameters": [ "parameters": [
{ {
"type": "integer", "type": "string",
"description": "container id", "description": "container id",
"name": "id", "name": "id",
"in": "path", "in": "path",
@ -19379,6 +19379,9 @@
"dto.ForwardRuleOperate": { "dto.ForwardRuleOperate": {
"type": "object", "type": "object",
"properties": { "properties": {
"forceDelete": {
"type": "boolean"
},
"rules": { "rules": {
"type": "array", "type": "array",
"items": { "items": {
@ -20705,6 +20708,9 @@
"dto.OllamaBindDomainRes": { "dto.OllamaBindDomainRes": {
"type": "object", "type": "object",
"properties": { "properties": {
"acmeAccountID": {
"type": "integer"
},
"allowIPs": { "allowIPs": {
"type": "array", "type": "array",
"items": { "items": {
@ -26718,7 +26724,7 @@
}, },
"securityDefinitions": { "securityDefinitions": {
"ApiKeyAuth": { "ApiKeyAuth": {
"description": "- `1Panel-Token` is the key for the panel API Key.", "description": "Custom Token Format, Format: md5('1panel' + API-Key + UnixTimestamp).\n```\neg:\ncurl -X GET \"http://localhost:4004/api/v1/dashboard/current\" \\\n-H \"1Panel-Token: \u003c1panel_token\u003e\" \\\n-H \"1Panel-Timestamp: \u003ccurrent_unix_timestamp\u003e\"\n```\n- `1Panel-Token` is the key for the panel API Key.",
"type": "apiKey", "type": "apiKey",
"name": "1Panel-Token", "name": "1Panel-Token",
"in": "header" "in": "header"

View file

@ -1578,6 +1578,8 @@ definitions:
type: object type: object
dto.ForwardRuleOperate: dto.ForwardRuleOperate:
properties: properties:
forceDelete:
type: boolean
rules: rules:
items: items:
properties: properties:
@ -2480,6 +2482,8 @@ definitions:
type: object type: object
dto.OllamaBindDomainRes: dto.OllamaBindDomainRes:
properties: properties:
acmeAccountID:
type: integer
allowIPs: allowIPs:
items: items:
type: string type: string
@ -8585,7 +8589,7 @@ paths:
in: path in: path
name: id name: id
required: true required: true
type: integer type: string
responses: responses:
"200": "200":
description: OK description: OK
@ -16762,7 +16766,15 @@ schemes:
- https - https
securityDefinitions: securityDefinitions:
ApiKeyAuth: ApiKeyAuth:
description: '- `1Panel-Token` is the key for the panel API Key.' description: |-
Custom Token Format, Format: md5('1panel' + API-Key + UnixTimestamp).
```
eg:
curl -X GET "http://localhost:4004/api/v1/dashboard/current" \
-H "1Panel-Token: <1panel_token>" \
-H "1Panel-Timestamp: <current_unix_timestamp>"
```
- `1Panel-Token` is the key for the panel API Key.
in: header in: header
name: 1Panel-Token name: 1Panel-Token
type: apiKey type: apiKey