rogee/quyun-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cde4fb8594b17951a2f53945cc3be473c1d3a0d7
quyun-v2/backend/docs/docs.go

9900 lines
345 KiB
Go
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.
// Package docs Code generated by swaggo/swag. DO NOT EDIT
package docs
import "github.com/rogeecn/swag"
const docTemplate = `{
"schemes": {{ marshal .Schemes }},
"swagger": "2.0",
"info": {
"description": "{{escape .Description}}",
"title": "{{.Title}}",
"termsOfService": "http://swagger.io/terms/",
"contact": {
"name": "UserName",
"url": "http://www.swagger.io/support",
"email": "support@swagger.io"
},
"license": {
"name": "Apache 2.0",
"url": "http://www.apache.org/licenses/LICENSE-2.0.html"
},
"version": "{{.Version}}"
},
"host": "{{.Host}}",
"basePath": "{{.BasePath}}",
"paths": {
"/super/v1/assets": {
"get": {
"description": "List assets across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Asset"
],
"summary": "List assets",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperAssetItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/assets/usage": {
"get": {
"description": "Asset usage statistics",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Asset"
],
"summary": "Asset usage",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperAssetUsageResponse"
}
}
}
}
},
"/super/v1/assets/{id}": {
"delete": {
"description": "Delete asset",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Asset"
],
"summary": "Delete asset",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Asset ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "boolean",
"description": "Force delete",
"name": "force",
"in": "query"
}
],
"responses": {
"200": {
"description": "Deleted",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/audit-logs": {
"get": {
"description": "List audit logs across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Audit"
],
"summary": "List audit logs",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperAuditLogItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/auth/login": {
"post": {
"description": "Login",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Auth"
],
"summary": "Login",
"parameters": [
{
"description": "Login form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.LoginForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.LoginResponse"
}
}
}
}
},
"/super/v1/auth/token": {
"get": {
"description": "Check token",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Auth"
],
"summary": "Check token",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.LoginResponse"
}
}
}
}
},
"/super/v1/comments": {
"get": {
"description": "List comments across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List comments",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperCommentItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/comments/{id}/delete": {
"post": {
"description": "Soft delete a comment",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Delete comment",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Comment ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Delete form",
"name": "form",
"in": "body",
"schema": {
"$ref": "#/definitions/dto.SuperCommentDeleteForm"
}
}
],
"responses": {
"200": {
"description": "Deleted",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/content-reports": {
"get": {
"description": "List content report records across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List content reports",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperContentReportItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/content-reports/process/batch": {
"post": {
"description": "Batch process content report records",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Batch process content reports",
"parameters": [
{
"description": "Batch process form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentReportBatchProcessForm"
}
}
],
"responses": {
"200": {
"description": "Processed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/content-reports/{id}/process": {
"post": {
"description": "Process a content report record",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Process content report",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Report ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Process form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentReportProcessForm"
}
}
],
"responses": {
"200": {
"description": "Processed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/contents": {
"get": {
"description": "List contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List contents",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.AdminContentItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/contents/review/batch": {
"post": {
"description": "Batch review contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Batch review contents",
"parameters": [
{
"description": "Batch review form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentBatchReviewForm"
}
}
],
"responses": {
"200": {
"description": "Reviewed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/contents/statistics": {
"get": {
"description": "Content statistics",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Content statistics",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperContentStatisticsResponse"
}
}
}
}
},
"/super/v1/contents/status/batch": {
"post": {
"description": "Batch unpublish or block contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Batch update content status",
"parameters": [
{
"description": "Batch status form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentBatchStatusForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/contents/{id}/review": {
"post": {
"description": "Review content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Review content",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Review form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentReviewForm"
}
}
],
"responses": {
"200": {
"description": "Reviewed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/coupon-grants": {
"get": {
"description": "List coupon grant records across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "List coupon grants",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperCouponGrantItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/coupon-risks": {
"get": {
"description": "List coupon risk records across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "List coupon risks",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperCouponRiskItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/coupons": {
"get": {
"description": "List coupon templates across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "List coupons",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperCouponItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/coupons/{id}/status": {
"patch": {
"description": "Update coupon status across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "Update coupon status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Coupon ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperCouponStatusUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/creator-applications": {
"get": {
"description": "List creator applications across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Creator"
],
"summary": "List creator applications",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/creator-applications/{id}/review": {
"post": {
"description": "Approve or reject creator application",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Creator"
],
"summary": "Review creator application",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Review form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperCreatorApplicationReviewForm"
}
}
],
"responses": {
"200": {
"description": "Reviewed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/creators": {
"get": {
"description": "List creator tenants (channels) across the platform",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Creator"
],
"summary": "List creators",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/creators/{tenantID}/payout-accounts": {
"post": {
"description": "Create payout account for tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Create payout account",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"description": "Create form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperPayoutAccountCreateForm"
}
}
],
"responses": {
"200": {
"description": "Created",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/creators/{tenantID}/settings": {
"get": {
"description": "Get creator settings by tenant ID",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Creator"
],
"summary": "Get creator settings",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.Settings"
}
}
}
},
"put": {
"description": "Update creator settings by tenant ID",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Creator"
],
"summary": "Update creator settings",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"description": "Settings form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.Settings"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/finance/anomalies/balances": {
"get": {
"description": "List balance anomalies across users",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "List balance anomalies",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperBalanceAnomalyItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/finance/anomalies/orders": {
"get": {
"description": "List order anomalies across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "List order anomalies",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperOrderAnomalyItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/finance/ledgers": {
"get": {
"description": "List tenant ledgers across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "List ledgers",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperLedgerItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/health/overview": {
"get": {
"description": "Platform health overview",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Health"
],
"summary": "Health overview",
"parameters": [
{
"type": "integer",
"description": "Tenant ID",
"name": "tenant_id",
"in": "query"
},
{
"type": "string",
"description": "Start time",
"name": "start_at",
"in": "query"
},
{
"type": "string",
"description": "End time",
"name": "end_at",
"in": "query"
},
{
"type": "integer",
"description": "Upload stuck hours",
"name": "upload_stuck_hours",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperHealthOverviewResponse"
}
}
}
}
},
"/super/v1/notifications": {
"get": {
"description": "List notifications across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Notification"
],
"summary": "List notifications",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperNotificationItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/notifications/broadcast": {
"post": {
"description": "Broadcast notification to users or tenant members",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Notification"
],
"summary": "Broadcast notification",
"parameters": [
{
"description": "Broadcast form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperNotificationBroadcastForm"
}
}
],
"responses": {
"200": {
"description": "Sent",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/notifications/templates": {
"get": {
"description": "List notification templates",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Notification"
],
"summary": "List notification templates",
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperNotificationTemplateItem"
}
}
}
}
]
}
}
}
},
"post": {
"description": "Create notification template",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Notification"
],
"summary": "Create notification template",
"parameters": [
{
"description": "Template form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperNotificationTemplateCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperNotificationTemplateItem"
}
}
}
}
},
"/super/v1/notifications/templates/{id}": {
"patch": {
"description": "Update notification template",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Notification"
],
"summary": "Update notification template",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Template ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperNotificationTemplateUpdateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperNotificationTemplateItem"
}
}
}
}
},
"/super/v1/orders": {
"get": {
"description": "List orders",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "List orders",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperOrderItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/orders/statistics": {
"get": {
"description": "Order statistics",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "Order statistics",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderStatisticsResponse"
}
}
}
}
},
"/super/v1/orders/{id}": {
"get": {
"description": "Get order",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "Get order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperOrderDetail"
}
}
}
}
},
"/super/v1/orders/{id}/flag": {
"post": {
"description": "Flag or unflag an order as problematic",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "Flag order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Flag form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperOrderFlagForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/orders/{id}/reconcile": {
"post": {
"description": "Mark or unmark order reconciliation status",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "Reconcile order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Reconcile form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperOrderReconcileForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/orders/{id}/refund": {
"post": {
"description": "Refund order",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Order"
],
"summary": "Refund order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Refund form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperOrderRefundForm"
}
}
],
"responses": {
"200": {
"description": "Refunded",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/payout-accounts": {
"get": {
"description": "List payout accounts across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "List payout accounts",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperPayoutAccountItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/payout-accounts/{id}": {
"delete": {
"description": "Remove payout account across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Remove payout account",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Payout account ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Removed",
"schema": {
"type": "string"
}
}
}
},
"patch": {
"description": "Update payout account across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Update payout account",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Payout account ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperPayoutAccountUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/payout-accounts/{id}/review": {
"post": {
"description": "Review payout account across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Review payout account",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Payout account ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Review form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperPayoutAccountReviewForm"
}
}
],
"responses": {
"200": {
"description": "Reviewed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/reports/export": {
"post": {
"description": "Export platform report data",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Report"
],
"summary": "Export report",
"parameters": [
{
"description": "Export form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperReportExportForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.ReportExportResponse"
}
}
}
}
},
"/super/v1/reports/overview": {
"get": {
"description": "Get platform report overview",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Report"
],
"summary": "Report overview",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.ReportOverviewResponse"
}
}
}
}
},
"/super/v1/system-configs": {
"get": {
"description": "List platform system configs",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"SystemConfig"
],
"summary": "List system configs",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperSystemConfigItem"
}
}
}
}
]
}
}
}
},
"post": {
"description": "Create platform system config",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"SystemConfig"
],
"summary": "Create system config",
"parameters": [
{
"description": "Create form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperSystemConfigCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperSystemConfigItem"
}
}
}
}
},
"/super/v1/system-configs/{id}": {
"patch": {
"description": "Update platform system config",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"SystemConfig"
],
"summary": "Update system config",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Config ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperSystemConfigUpdateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperSystemConfigItem"
}
}
}
}
},
"/super/v1/tenant-join-requests": {
"get": {
"description": "List tenant join requests across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "List tenant join requests",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperTenantJoinRequestItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/tenant-join-requests/{id}/review": {
"post": {
"description": "Approve or reject a tenant join request",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Review tenant join request",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Join request ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Review form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TenantJoinReviewForm"
}
}
],
"responses": {
"200": {
"description": "Reviewed",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/tenants": {
"get": {
"description": "List tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "List tenants",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
},
{
"type": "string",
"description": "Name",
"name": "name",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantItem"
}
}
}
}
]
}
}
}
},
"post": {
"description": "Create tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Create tenant",
"parameters": [
{
"description": "Create form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TenantCreateForm"
}
}
],
"responses": {
"200": {
"description": "Created",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/tenants/health": {
"get": {
"description": "Tenant health overview",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Tenant health overview",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantHealthItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/tenants/statuses": {
"get": {
"description": "Tenant statuses",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Tenant statuses",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/requests.KV"
}
}
}
}
}
},
"/super/v1/tenants/{id}": {
"get": {
"description": "Get tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Get tenant",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.TenantItem"
}
}
}
},
"patch": {
"description": "Update tenant expire",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Update tenant expire",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TenantExpireUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/tenants/{id}/status": {
"patch": {
"description": "Update tenant status",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Update tenant status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TenantStatusUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/contents": {
"get": {
"description": "List contents by tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List tenant contents",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.AdminContentItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/tenants/{tenantID}/contents/{contentID}/status": {
"patch": {
"description": "Update content status",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Update content status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "contentID",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperTenantContentStatusUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/coupons": {
"post": {
"description": "Create coupon for tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "Create coupon",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"description": "Create form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.CouponCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.CouponItem"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/coupons/{id}": {
"get": {
"description": "Get coupon detail",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "Get coupon",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "Coupon ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.CouponItem"
}
}
}
},
"put": {
"description": "Update coupon for tenant",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "Update coupon",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "Coupon ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.CouponUpdateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.CouponItem"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/coupons/{id}/grant": {
"post": {
"description": "Grant coupon to users",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Coupon"
],
"summary": "Grant coupon",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "Coupon ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Grant form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.CouponGrantForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperCouponGrantResponse"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/invites": {
"post": {
"description": "Create tenant invite code",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "Create tenant invite",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"description": "Invite form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TenantInviteCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.TenantInviteItem"
}
}
}
}
},
"/super/v1/tenants/{tenantID}/users": {
"get": {
"description": "List tenant users",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "List tenant users",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"name": "tenantID",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperTenantUserItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users": {
"get": {
"description": "List users",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List users",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
},
{
"type": "string",
"description": "Username",
"name": "username",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/statistics": {
"get": {
"description": "User statistics",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "User statistics",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserStatistics"
}
}
}
}
}
},
"/super/v1/users/statuses": {
"get": {
"description": "User statuses",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "User statuses",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/requests.KV"
}
}
}
}
}
},
"/super/v1/users/{id}": {
"get": {
"description": "Get user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Get user",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UserItem"
}
}
}
},
"patch": {
"description": "Update user profile fields",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Update user profile",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperUserProfileUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/users/{id}/coupons": {
"get": {
"description": "List coupons of a user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user coupons",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserCouponItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/favorites": {
"get": {
"description": "List user's favorited contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user favorites",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserContentActionItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/following": {
"get": {
"description": "List tenants followed by user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user following tenants",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserTenantItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/library": {
"get": {
"description": "List purchased contents of a user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user library",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserLibraryItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/likes": {
"get": {
"description": "List user's liked contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user likes",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserContentActionItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/notifications": {
"get": {
"description": "List notifications of a user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user notifications",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserNotificationItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/realname": {
"get": {
"description": "Get real-name verification detail of a user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Get user real-name verification detail",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperUserRealNameResponse"
}
}
}
}
},
"/super/v1/users/{id}/roles": {
"patch": {
"description": "Update user roles",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Update user roles",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.UserRolesUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/users/{id}/status": {
"patch": {
"description": "Update user status",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Update user status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.UserStatusUpdateForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/users/{id}/tenants": {
"get": {
"description": "List tenants joined by user",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "List user tenants",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserTenantItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/users/{id}/wallet": {
"get": {
"description": "Get user wallet balance and transactions",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Get user wallet",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.SuperWalletResponse"
}
}
}
}
},
"/super/v1/withdrawals": {
"get": {
"description": "List withdrawal orders across tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "List withdrawals",
"parameters": [
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "Page size",
"name": "limit",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperOrderItem"
}
}
}
}
]
}
}
}
}
},
"/super/v1/withdrawals/{id}/approve": {
"post": {
"description": "Approve a withdrawal request",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Approve withdrawal",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Withdrawal order ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Approved",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/withdrawals/{id}/reject": {
"post": {
"description": "Reject a withdrawal request",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Reject withdrawal",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Withdrawal order ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Reject form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperWithdrawalRejectForm"
}
}
],
"responses": {
"200": {
"description": "Rejected",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/auth/login": {
"post": {
"description": "Login or register user using phone number and OTP",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Auth"
],
"summary": "Login or Register with OTP",
"parameters": [
{
"description": "Login form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.LoginForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.LoginResponse"
}
}
}
}
},
"/v1/auth/otp": {
"post": {
"description": "Send OTP to phone number",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Auth"
],
"summary": "Send OTP",
"parameters": [
{
"description": "Phone number",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.SendOTPForm"
}
}
],
"responses": {
"200": {
"description": "OTP sent",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/comments/{id}/like": {
"post": {
"description": "Like a comment",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Like comment",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Comment ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Liked",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/common/options": {
"get": {
"description": "Get global options (enums)",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Get options",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OptionsResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/contents": {
"get": {
"description": "List contents with filtering and pagination",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List contents",
"parameters": [
{
"type": "string",
"description": "Search keyword",
"name": "keyword",
"in": "query"
},
{
"type": "string",
"description": "Genre",
"name": "genre",
"in": "query"
},
{
"type": "integer",
"format": "int64",
"description": "Filter by tenant",
"name": "tenant_id",
"in": "query"
},
{
"type": "integer",
"format": "int64",
"description": "Filter by author",
"name": "author_id",
"in": "query"
},
{
"enum": [
"latest",
"hot",
"price_asc"
],
"type": "string",
"description": "Sort order",
"name": "sort",
"in": "query"
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.ContentItem"
}
}
}
}
]
}
}
}
}
},
"/v1/t/{tenantCode}/contents/{id}": {
"get": {
"description": "Get content detail by ID",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Get content detail",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.ContentDetail"
}
}
}
}
},
"/v1/t/{tenantCode}/contents/{id}/comments": {
"get": {
"description": "Get comments for a content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Get comments",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.Comment"
}
}
}
}
]
}
}
}
},
"post": {
"description": "Post a comment to a content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Post comment",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Comment form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.CommentCreateForm"
}
}
],
"responses": {
"200": {
"description": "Comment created",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/contents/{id}/favorite": {
"post": {
"tags": [
"Content"
],
"summary": "Add favorite",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Favorited",
"schema": {
"type": "string"
}
}
}
},
"delete": {
"tags": [
"Content"
],
"summary": "Remove favorite",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Unfavorited",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/contents/{id}/like": {
"post": {
"tags": [
"Content"
],
"summary": "Add like",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Liked",
"schema": {
"type": "string"
}
}
}
},
"delete": {
"tags": [
"Content"
],
"summary": "Remove like",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Unliked",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me": {
"get": {
"description": "Get current user profile",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get user profile",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.User"
}
}
}
},
"put": {
"description": "Update user profile",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Update user profile",
"parameters": [
{
"description": "Update form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.UserUpdate"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/coupons": {
"get": {
"description": "List my coupons",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "List coupons",
"parameters": [
{
"type": "string",
"description": "Status (unused, used, expired)",
"name": "status",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserCouponItem"
}
}
}
}
}
},
"/v1/t/{tenantCode}/me/coupons/available": {
"get": {
"description": "List coupons available for the given order amount",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "List available coupons",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order amount (cents)",
"name": "amount",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.UserCouponItem"
}
}
}
}
}
},
"/v1/t/{tenantCode}/me/coupons/receive": {
"post": {
"description": "Receive a coupon by coupon_id",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Receive coupon",
"parameters": [
{
"description": "Receive form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.CouponReceiveForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UserCouponItem"
}
}
}
}
},
"/v1/t/{tenantCode}/me/favorites": {
"get": {
"description": "Get favorites",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get favorites",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.ContentItem"
}
}
}
}
},
"post": {
"description": "Add to favorites",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Add favorite",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "content_id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "Added",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/favorites/{contentId}": {
"delete": {
"description": "Remove from favorites",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Remove favorite",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "contentId",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Removed",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/following": {
"get": {
"description": "Get following tenants",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get following",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantProfile"
}
}
}
}
}
},
"/v1/t/{tenantCode}/me/library": {
"get": {
"description": "Get purchased content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get library",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.ContentItem"
}
}
}
}
}
},
"/v1/t/{tenantCode}/me/likes": {
"get": {
"description": "Get liked contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get likes",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.ContentItem"
}
}
}
}
},
"post": {
"description": "Like content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Like content",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "content_id",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "Liked",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/likes/{contentId}": {
"delete": {
"description": "Unlike content",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Unlike content",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Content ID",
"name": "contentId",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "Unliked",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/notifications": {
"get": {
"description": "Get notifications",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get notifications",
"parameters": [
{
"type": "string",
"description": "Type enum(all, system, order, audit, interaction)",
"name": "type",
"in": "query"
},
{
"type": "integer",
"description": "Page number",
"name": "page",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.Notification"
}
}
}
}
]
}
}
}
}
},
"/v1/t/{tenantCode}/me/notifications/read-all": {
"post": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Mark all as read",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/notifications/{id}/read": {
"post": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Mark as read",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Notification ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/orders": {
"get": {
"description": "List user orders",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "List orders",
"parameters": [
{
"type": "string",
"description": "Status enum(all, unpaid, completed, refund)",
"name": "status",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.Order"
}
}
}
}
}
},
"/v1/t/{tenantCode}/me/orders/{id}": {
"get": {
"description": "Get user order detail",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get order detail",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Order ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.Order"
}
}
}
}
},
"/v1/t/{tenantCode}/me/realname": {
"post": {
"description": "Submit real-name authentication",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Realname auth",
"parameters": [
{
"description": "Realname form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RealNameForm"
}
}
],
"responses": {
"200": {
"description": "Submitted",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/me/wallet": {
"get": {
"description": "Get wallet balance and transactions",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Get wallet",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.WalletResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/me/wallet/recharge": {
"post": {
"description": "Recharge wallet",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"UserCenter"
],
"summary": "Recharge wallet",
"parameters": [
{
"description": "Recharge form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RechargeForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.RechargeResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/media-assets/{id}": {
"delete": {
"description": "Delete media asset",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Delete media asset",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "Asset ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/storage/{any}": {
"get": {
"consumes": [
"application/json"
],
"produces": [
"application/octet-stream"
],
"tags": [
"Storage"
],
"summary": "Download file",
"parameters": [
{
"type": "string",
"description": "any path",
"name": "any",
"in": "path"
},
{
"type": "string",
"description": "Expiry",
"name": "expires",
"in": "query",
"required": true
},
{
"type": "string",
"description": "Signature",
"name": "sign",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "file"
}
}
}
},
"put": {
"consumes": [
"application/octet-stream"
],
"produces": [
"application/json"
],
"tags": [
"Storage"
],
"summary": "Upload file",
"parameters": [
{
"type": "string",
"description": "any path",
"name": "any",
"in": "path"
},
{
"type": "string",
"description": "Expiry",
"name": "expires",
"in": "query",
"required": true
},
{
"type": "string",
"description": "Signature",
"name": "sign",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "success",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/topics": {
"get": {
"description": "List curated topics",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "List topics",
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/dto.Topic"
}
}
}
}
}
},
"/v1/t/{tenantCode}/upload": {
"post": {
"description": "Upload file",
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Upload file",
"parameters": [
{
"type": "file",
"description": "File",
"name": "file",
"in": "formData",
"required": true
},
{
"type": "string",
"description": "Type 上传资源类型（如 cover/media/avatar）。",
"name": "type",
"in": "formData"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UploadResult"
}
}
}
}
},
"/v1/t/{tenantCode}/upload/check": {
"get": {
"description": "Check if file hash exists",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Check hash",
"parameters": [
{
"type": "string",
"description": "File MD5 Hash",
"name": "hash",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UploadResult"
}
}
}
}
},
"/v1/t/{tenantCode}/upload/complete": {
"post": {
"description": "Complete multipart upload",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Complete upload",
"parameters": [
{
"description": "Complete form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.UploadCompleteForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UploadResult"
}
}
}
}
},
"/v1/t/{tenantCode}/upload/init": {
"post": {
"description": "Initialize multipart upload",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Init multipart upload",
"parameters": [
{
"description": "Init form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.UploadInitForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.UploadInitResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/upload/part": {
"post": {
"description": "Upload a part",
"consumes": [
"multipart/form-data"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Upload part",
"parameters": [
{
"type": "file",
"description": "Part File",
"name": "file",
"in": "formData",
"required": true
},
{
"type": "integer",
"description": "PartNumber 分片序号（从 1 开始）。",
"name": "part_number",
"in": "formData"
},
{
"type": "string",
"description": "UploadID 分片上传ID。",
"name": "upload_id",
"in": "formData"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/v1/t/{tenantCode}/upload/{uploadId}": {
"delete": {
"description": "Abort multipart upload",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Common"
],
"summary": "Abort upload",
"parameters": [
{
"type": "string",
"description": "Upload ID",
"name": "uploadId",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
}
},
"definitions": {
"consts.ContentAccessStatus": {
"type": "string",
"enum": [
"active",
"revoked",
"expired"
],
"x-enum-varnames": [
"ContentAccessStatusActive",
"ContentAccessStatusRevoked",
"ContentAccessStatusExpired"
]
},
"consts.ContentStatus": {
"type": "string",
"enum": [
"draft",
"reviewing",
"published",
"unpublished",
"blocked"
],
"x-enum-varnames": [
"ContentStatusDraft",
"ContentStatusReviewing",
"ContentStatusPublished",
"ContentStatusUnpublished",
"ContentStatusBlocked"
]
},
"consts.CouponType": {
"type": "string",
"enum": [
"fix_amount",
"discount"
],
"x-enum-varnames": [
"CouponTypeFixAmount",
"CouponTypeDiscount"
]
},
"consts.Currency": {
"type": "string",
"enum": [
"CNY"
],
"x-enum-varnames": [
"CurrencyCNY"
]
},
"consts.Gender": {
"type": "string",
"enum": [
"male",
"female",
"secret"
],
"x-enum-varnames": [
"GenderMale",
"GenderFemale",
"GenderSecret"
]
},
"consts.MediaAssetStatus": {
"type": "string",
"enum": [
"uploaded",
"processing",
"ready",
"failed",
"deleted"
],
"x-enum-varnames": [
"MediaAssetStatusUploaded",
"MediaAssetStatusProcessing",
"MediaAssetStatusReady",
"MediaAssetStatusFailed",
"MediaAssetStatusDeleted"
]
},
"consts.MediaAssetType": {
"type": "string",
"enum": [
"video",
"audio",
"image"
],
"x-enum-varnames": [
"MediaAssetTypeVideo",
"MediaAssetTypeAudio",
"MediaAssetTypeImage"
]
},
"consts.MediaAssetVariant": {
"type": "string",
"enum": [
"main",
"preview"
],
"x-enum-varnames": [
"MediaAssetVariantMain",
"MediaAssetVariantPreview"
]
},
"consts.NotificationType": {
"type": "string",
"enum": [
"system",
"order",
"audit",
"interaction"
],
"x-enum-varnames": [
"NotificationTypeSystem",
"NotificationTypeOrder",
"NotificationTypeAudit",
"NotificationTypeInteraction"
]
},
"consts.OrderStatus": {
"type": "string",
"enum": [
"created",
"paid",
"refunding",
"refunded",
"canceled",
"failed"
],
"x-enum-varnames": [
"OrderStatusCreated",
"OrderStatusPaid",
"OrderStatusRefunding",
"OrderStatusRefunded",
"OrderStatusCanceled",
"OrderStatusFailed"
]
},
"consts.OrderType": {
"type": "string",
"enum": [
"content_purchase",
"recharge",
"withdrawal"
],
"x-enum-varnames": [
"OrderTypeContentPurchase",
"OrderTypeRecharge",
"OrderTypeWithdrawal"
]
},
"consts.PayoutAccountStatus": {
"type": "string",
"enum": [
"pending",
"approved",
"rejected"
],
"x-enum-varnames": [
"PayoutAccountStatusPending",
"PayoutAccountStatusApproved",
"PayoutAccountStatusRejected"
]
},
"consts.Role": {
"type": "string",
"enum": [
"user",
"super_admin",
"creator"
],
"x-enum-varnames": [
"RoleUser",
"RoleSuperAdmin",
"RoleCreator"
]
},
"consts.TenantLedgerType": {
"type": "string",
"enum": [
"debit_purchase",
"credit_refund",
"credit_withdrawal",
"freeze",
"unfreeze",
"adjustment"
],
"x-enum-varnames": [
"TenantLedgerTypeDebitPurchase",
"TenantLedgerTypeCreditRefund",
"TenantLedgerTypeCreditWithdrawal",
"TenantLedgerTypeFreeze",
"TenantLedgerTypeUnfreeze",
"TenantLedgerTypeAdjustment"
]
},
"consts.TenantStatus": {
"type": "string",
"enum": [
"pending_verify",
"verified",
"banned"
],
"x-enum-varnames": [
"TenantStatusPendingVerify",
"TenantStatusVerified",
"TenantStatusBanned"
]
},
"consts.TenantUserRole": {
"type": "string",
"enum": [
"member",
"tenant_admin"
],
"x-enum-varnames": [
"TenantUserRoleMember",
"TenantUserRoleTenantAdmin"
]
},
"consts.UserContentActionType": {
"type": "string",
"enum": [
"like",
"favorite"
],
"x-enum-varnames": [
"UserContentActionTypeLike",
"UserContentActionTypeFavorite"
]
},
"consts.UserCouponStatus": {
"type": "string",
"enum": [
"unused",
"used",
"expired"
],
"x-enum-varnames": [
"UserCouponStatusUnused",
"UserCouponStatusUsed",
"UserCouponStatusExpired"
]
},
"consts.UserStatus": {
"type": "string",
"enum": [
"active",
"inactive",
"pending_verify",
"verified",
"banned"
],
"x-enum-varnames": [
"UserStatusActive",
"UserStatusInactive",
"UserStatusPendingVerify",
"UserStatusVerified",
"UserStatusBanned"
]
},
"dto.AdminContentItem": {
"type": "object",
"properties": {
"content": {
"description": "Content 内容摘要信息。",
"allOf": [
{
"$ref": "#/definitions/dto.ContentItem"
}
]
},
"owner": {
"description": "Owner 内容作者用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.AdminContentOwnerLite"
}
]
},
"price": {
"description": "Price 内容价格信息。",
"allOf": [
{
"$ref": "#/definitions/dto.ContentPrice"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant": {
"description": "Tenant 内容所属租户信息，用于超管列表展示与跳转。",
"allOf": [
{
"$ref": "#/definitions/dto.SuperContentTenantLite"
}
]
},
"visibility_description": {
"description": "VisibilityDescription 可见性描述（用于展示）。",
"type": "string"
}
}
},
"dto.AdminContentOwnerLite": {
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.Comment": {
"type": "object",
"properties": {
"content": {
"description": "Content 评论内容。",
"type": "string"
},
"create_time": {
"description": "CreateTime 评论创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 评论ID。",
"type": "integer"
},
"is_liked": {
"description": "IsLiked 当前用户是否点赞该评论。",
"type": "boolean"
},
"likes": {
"description": "Likes 评论点赞数。",
"type": "integer"
},
"reply_to": {
"description": "ReplyTo 回复的评论ID（0 表示一级评论）。",
"type": "integer"
},
"user_avatar": {
"description": "UserAvatar 评论用户头像。",
"type": "string"
},
"user_id": {
"description": "UserID 评论用户ID。",
"type": "integer"
},
"user_nickname": {
"description": "UserNickname 评论用户昵称。",
"type": "string"
}
}
},
"dto.CommentCreateForm": {
"type": "object",
"properties": {
"content": {
"description": "Content 评论正文，不能为空。",
"type": "string"
},
"reply_to": {
"description": "ReplyTo 被回复评论ID（0 表示一级评论）。",
"type": "integer"
}
}
},
"dto.ContentDetail": {
"type": "object",
"properties": {
"author_avatar": {
"description": "AuthorAvatar 作者头像URL。",
"type": "string"
},
"author_id": {
"description": "AuthorID 作者用户ID。",
"type": "integer"
},
"author_is_following": {
"description": "AuthorIsFollowing 当前用户是否关注作者（未登录默认 false）。",
"type": "boolean"
},
"author_name": {
"description": "AuthorName 作者展示名（优先昵称）。",
"type": "string"
},
"body": {
"description": "Body 详细正文/图文内容（文章类可为空）。",
"type": "string"
},
"cover": {
"description": "Cover 封面URL（无封面时为空）。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339 格式）。",
"type": "string"
},
"description": {
"description": "Description 内容描述（用于详情页摘要）。",
"type": "string"
},
"genre": {
"description": "Genre 内容分类/风格标签。",
"type": "string"
},
"id": {
"description": "ID 内容唯一ID。",
"type": "integer"
},
"is_favorited": {
"description": "IsFavorited 当前用户是否收藏。",
"type": "boolean"
},
"is_liked": {
"description": "IsLiked 当前用户是否点赞。",
"type": "boolean"
},
"is_purchased": {
"description": "IsPurchased 是否已购买（用于内容列表快速判断）。",
"type": "boolean"
},
"likes": {
"description": "Likes 点赞数统计。",
"type": "integer"
},
"media_urls": {
"description": "MediaUrls 关联媒体资源（音频/视频/预览）。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.MediaURL"
}
},
"meta": {
"description": "Meta 内容元信息（曲风/调性/节拍等）。",
"allOf": [
{
"$ref": "#/definitions/dto.Meta"
}
]
},
"price": {
"description": "Price 价格（单位元，免费为 0）。",
"type": "number"
},
"published_at": {
"description": "PublishedAt 发布时间，未发布为空。",
"type": "string"
},
"status": {
"description": "Status 内容状态（如 published/unpublished）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 内容所属租户ID。",
"type": "integer"
},
"title": {
"description": "Title 内容标题。",
"type": "string"
},
"type": {
"description": "Type 内容媒体类型（video/audio/article）。",
"type": "string"
},
"user_id": {
"description": "UserID 内容作者用户ID（与 author_id 同义，便于后台展示）。",
"type": "integer"
},
"views": {
"description": "Views 浏览量统计。",
"type": "integer"
},
"visibility": {
"description": "Visibility 内容可见性（如 public/tenant_only/private）。",
"type": "string"
}
}
},
"dto.ContentItem": {
"type": "object",
"properties": {
"author_avatar": {
"description": "AuthorAvatar 作者头像URL。",
"type": "string"
},
"author_id": {
"description": "AuthorID 作者用户ID。",
"type": "integer"
},
"author_is_following": {
"description": "AuthorIsFollowing 当前用户是否关注作者（未登录默认 false）。",
"type": "boolean"
},
"author_name": {
"description": "AuthorName 作者展示名（优先昵称）。",
"type": "string"
},
"cover": {
"description": "Cover 封面URL（无封面时为空）。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339 格式）。",
"type": "string"
},
"genre": {
"description": "Genre 内容分类/风格标签。",
"type": "string"
},
"id": {
"description": "ID 内容唯一ID。",
"type": "integer"
},
"is_purchased": {
"description": "IsPurchased 是否已购买（用于内容列表快速判断）。",
"type": "boolean"
},
"likes": {
"description": "Likes 点赞数统计。",
"type": "integer"
},
"price": {
"description": "Price 价格（单位元，免费为 0）。",
"type": "number"
},
"published_at": {
"description": "PublishedAt 发布时间，未发布为空。",
"type": "string"
},
"status": {
"description": "Status 内容状态（如 published/unpublished）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 内容所属租户ID。",
"type": "integer"
},
"title": {
"description": "Title 内容标题。",
"type": "string"
},
"type": {
"description": "Type 内容媒体类型（video/audio/article）。",
"type": "string"
},
"user_id": {
"description": "UserID 内容作者用户ID（与 author_id 同义，便于后台展示）。",
"type": "integer"
},
"views": {
"description": "Views 浏览量统计。",
"type": "integer"
},
"visibility": {
"description": "Visibility 内容可见性（如 public/tenant_only/private）。",
"type": "string"
}
}
},
"dto.ContentPrice": {
"type": "object",
"properties": {
"currency": {
"description": "Currency 币种（CNY 等）。",
"type": "string"
},
"discount_end_at": {
"description": "DiscountEndAt 折扣结束时间（RFC3339）。",
"type": "string"
},
"discount_start_at": {
"description": "DiscountStartAt 折扣开始时间（RFC3339）。",
"type": "string"
},
"discount_type": {
"description": "DiscountType 折扣类型（amount/percent）。",
"type": "string"
},
"discount_value": {
"description": "DiscountValue 折扣值（amount=元，percent=百分比）。",
"type": "number"
},
"price_amount": {
"description": "PriceAmount 原价金额（单位元）。",
"type": "number"
}
}
},
"dto.CouponCreateForm": {
"type": "object",
"properties": {
"description": {
"description": "Description 优惠券描述。",
"type": "string"
},
"end_at": {
"description": "EndAt 过期时间（RFC3339，可为空）。",
"type": "string"
},
"max_discount": {
"description": "MaxDiscount 折扣券最高抵扣金额（分）。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 使用门槛金额（分）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339，可为空）。",
"type": "string"
},
"title": {
"description": "Title 优惠券标题。",
"type": "string"
},
"total_quantity": {
"description": "TotalQuantity 发行总量（0 表示不限量）。",
"type": "integer"
},
"type": {
"description": "Type 优惠券类型（fix_amount/discount）。",
"type": "string"
},
"value": {
"description": "Value 优惠券面值（分/折扣百分比）。",
"type": "integer"
}
}
},
"dto.CouponGrantForm": {
"type": "object",
"properties": {
"user_ids": {
"description": "UserIDs 领取用户ID集合。",
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"dto.CouponItem": {
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"description": {
"description": "Description 优惠券描述。",
"type": "string"
},
"end_at": {
"description": "EndAt 过期时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 券模板ID。",
"type": "integer"
},
"max_discount": {
"description": "MaxDiscount 折扣券最高抵扣金额（分）。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 使用门槛金额（分）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339）。",
"type": "string"
},
"title": {
"description": "Title 优惠券标题。",
"type": "string"
},
"total_quantity": {
"description": "TotalQuantity 发行总量。",
"type": "integer"
},
"type": {
"description": "Type 优惠券类型（fix_amount/discount）。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"used_quantity": {
"description": "UsedQuantity 已使用数量。",
"type": "integer"
},
"value": {
"description": "Value 优惠券面值（分/折扣百分比）。",
"type": "integer"
}
}
},
"dto.CouponReceiveForm": {
"type": "object",
"properties": {
"coupon_id": {
"description": "CouponID 券模板ID。",
"type": "integer"
}
}
},
"dto.CouponUpdateForm": {
"type": "object",
"properties": {
"description": {
"description": "Description 优惠券描述（为空表示不修改）。",
"type": "string"
},
"end_at": {
"description": "EndAt 过期时间（RFC3339，可为空）。",
"type": "string"
},
"max_discount": {
"description": "MaxDiscount 折扣券最高抵扣金额（分）。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 使用门槛金额（分）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339，可为空）。",
"type": "string"
},
"title": {
"description": "Title 优惠券标题（为空表示不修改）。",
"type": "string"
},
"total_quantity": {
"description": "TotalQuantity 发行总量（0 表示不限量）。",
"type": "integer"
},
"type": {
"description": "Type 优惠券类型（fix_amount/discount）。",
"type": "string"
},
"value": {
"description": "Value 优惠券面值（分/折扣百分比）。",
"type": "integer"
}
}
},
"dto.MediaURL": {
"type": "object",
"properties": {
"duration": {
"description": "Duration 媒体时长（秒），无时长则为 0。",
"type": "integer"
},
"type": {
"description": "Type 媒体类型（audio/video/image/preview）。",
"type": "string"
},
"url": {
"description": "URL 媒体资源地址。",
"type": "string"
}
}
},
"dto.Meta": {
"type": "object",
"properties": {
"beat": {
"description": "Beat 节拍信息（如 4/4）。",
"type": "string"
},
"key": {
"description": "Key 音乐调性或主音。",
"type": "string"
},
"role": {
"description": "Role 内容角色/定位（如 demo/主稿）。",
"type": "string"
}
}
},
"dto.Notification": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容。",
"type": "string"
},
"id": {
"description": "ID 通知ID。",
"type": "integer"
},
"read": {
"description": "Read 是否已读。",
"type": "boolean"
},
"time": {
"description": "Time 发送时间（RFC3339）。",
"type": "string"
},
"title": {
"description": "Title 通知标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型（system/order/interaction）。",
"type": "string"
}
}
},
"dto.OptionsResponse": {
"type": "object",
"properties": {
"content_genre": {
"description": "ContentGenre 内容类型/分类选项。",
"type": "array",
"items": {
"$ref": "#/definitions/requests.KV"
}
},
"content_status": {
"description": "ContentStatus 内容状态选项。",
"type": "array",
"items": {
"$ref": "#/definitions/requests.KV"
}
}
}
},
"dto.Order": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 实付金额（单位元）。",
"type": "number"
},
"buyer_avatar": {
"description": "BuyerAvatar 买家头像URL。",
"type": "string"
},
"buyer_name": {
"description": "BuyerName 买家昵称。",
"type": "string"
},
"cover": {
"description": "Cover 订单封面图。",
"type": "string"
},
"create_time": {
"description": "CreateTime 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 订单ID。",
"type": "integer"
},
"is_virtual": {
"description": "IsVirtual 是否虚拟订单。",
"type": "boolean"
},
"items": {
"description": "Items 订单内容明细。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.ContentItem"
}
},
"pay_time": {
"description": "PayTime 支付时间（RFC3339）。",
"type": "string"
},
"quantity": {
"description": "Quantity 内容数量。",
"type": "integer"
},
"status": {
"description": "Status 订单状态。",
"type": "string"
},
"status_description": {
"description": "StatusDescription 订单状态描述。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 内容所属租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"title": {
"description": "Title 订单标题（用于列表展示）。",
"type": "string"
},
"type": {
"description": "Type 订单类型（内容购买/充值等）。",
"type": "string"
},
"type_description": {
"description": "TypeDescription 订单类型描述。",
"type": "string"
}
}
},
"dto.OrderBuyerLite": {
"type": "object",
"properties": {
"id": {
"description": "ID 买家用户ID。",
"type": "integer"
},
"username": {
"description": "Username 买家用户名。",
"type": "string"
}
}
},
"dto.OrderStatisticsResponse": {
"type": "object",
"properties": {
"by_status": {
"description": "ByStatus 按状态聚合统计。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.OrderStatisticsRow"
}
},
"total_amount_paid_sum": {
"description": "TotalAmountPaidSum 实付总额（分）。",
"type": "integer"
},
"total_count": {
"description": "TotalCount 订单总数。",
"type": "integer"
}
}
},
"dto.OrderStatisticsRow": {
"type": "object",
"properties": {
"amount_paid_sum": {
"description": "AmountPaidSum 该状态实付总额（分）。",
"type": "integer"
},
"count": {
"description": "Count 该状态订单数量。",
"type": "integer"
},
"status": {
"description": "Status 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
}
}
},
"dto.OrderTenantLite": {
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
}
}
},
"dto.PaymentWebhookForm": {
"type": "object",
"properties": {
"external_id": {
"description": "ExternalID 第三方支付流水号。",
"type": "string"
},
"order_id": {
"description": "OrderID 订单ID。",
"type": "integer"
}
}
},
"dto.RealNameForm": {
"type": "object",
"properties": {
"id_card": {
"description": "IDCard 身份证号。",
"type": "string"
},
"realname": {
"description": "Realname 真实姓名。",
"type": "string"
}
}
},
"dto.RechargeForm": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 充值金额（单位元）。",
"type": "number"
},
"method": {
"description": "Method 充值方式（alipay）。",
"type": "string"
}
}
},
"dto.RechargeResponse": {
"type": "object",
"properties": {
"order_id": {
"description": "OrderID 充值订单ID。",
"type": "integer"
},
"pay_params": {
"description": "PayParams 支付参数（透传给前端）。",
"type": "string"
}
}
},
"dto.ReportExportResponse": {
"type": "object",
"properties": {
"content": {
"description": "Content 导出内容（CSV 文本）。",
"type": "string"
},
"filename": {
"description": "Filename 导出文件名。",
"type": "string"
},
"mime_type": {
"description": "MimeType 导出内容类型。",
"type": "string"
}
}
},
"dto.ReportOverviewItem": {
"type": "object",
"properties": {
"comment_count": {
"description": "CommentCount 当日新增评论数。",
"type": "integer"
},
"content_created": {
"description": "ContentCreated 当日新增内容数。",
"type": "integer"
},
"date": {
"description": "Date 日期（YYYY-MM-DD）。",
"type": "string"
},
"favorite_actions": {
"description": "FavoriteActions 当日新增收藏数（基于互动记录）。",
"type": "integer"
},
"like_actions": {
"description": "LikeActions 当日新增点赞数（基于互动记录）。",
"type": "integer"
},
"paid_amount": {
"description": "PaidAmount 当日已支付金额（单位元）。",
"type": "number"
},
"paid_orders": {
"description": "PaidOrders 当日已支付订单数。",
"type": "integer"
},
"refund_amount": {
"description": "RefundAmount 当日退款金额（单位元）。",
"type": "number"
},
"refund_orders": {
"description": "RefundOrders 当日退款订单数。",
"type": "integer"
},
"withdrawal_apply_amount": {
"description": "WithdrawalApplyAmount 当日提现申请金额（单位元）。",
"type": "number"
},
"withdrawal_apply_orders": {
"description": "WithdrawalApplyOrders 当日提现申请订单数。",
"type": "integer"
},
"withdrawal_failed_amount": {
"description": "WithdrawalFailedAmount 当日提现失败金额（单位元）。",
"type": "number"
},
"withdrawal_failed_orders": {
"description": "WithdrawalFailedOrders 当日提现失败订单数。",
"type": "integer"
},
"withdrawal_paid_amount": {
"description": "WithdrawalPaidAmount 当日提现完成金额（单位元）。",
"type": "number"
},
"withdrawal_paid_orders": {
"description": "WithdrawalPaidOrders 当日提现完成订单数。",
"type": "integer"
}
}
},
"dto.ReportOverviewResponse": {
"type": "object",
"properties": {
"items": {
"description": "Items 按日期拆分的趋势数据。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.ReportOverviewItem"
}
},
"summary": {
"description": "Summary 汇总指标。",
"allOf": [
{
"$ref": "#/definitions/dto.ReportSummary"
}
]
}
}
},
"dto.ReportSummary": {
"type": "object",
"properties": {
"comment_count": {
"description": "CommentCount 统计区间内新增评论数。",
"type": "integer"
},
"content_count": {
"description": "ContentCount 内容总量（当前快照）。",
"type": "integer"
},
"content_created": {
"description": "ContentCreated 统计区间内新增内容数。",
"type": "integer"
},
"conversion_rate": {
"description": "ConversionRate 转化率（已支付订单数 / 累计曝光）。",
"type": "number"
},
"favorite_actions": {
"description": "FavoriteActions 统计区间内新增收藏数（基于互动记录）。",
"type": "integer"
},
"like_actions": {
"description": "LikeActions 统计区间内新增点赞数（基于互动记录）。",
"type": "integer"
},
"paid_amount": {
"description": "PaidAmount 统计区间内已支付金额（单位元）。",
"type": "number"
},
"paid_orders": {
"description": "PaidOrders 统计区间内已支付订单数。",
"type": "integer"
},
"refund_amount": {
"description": "RefundAmount 统计区间内退款金额（单位元）。",
"type": "number"
},
"refund_orders": {
"description": "RefundOrders 统计区间内退款订单数。",
"type": "integer"
},
"total_views": {
"description": "TotalViews 内容累计曝光（全量累计值，用于粗略换算）。",
"type": "integer"
},
"withdrawal_apply_amount": {
"description": "WithdrawalApplyAmount 统计区间内提现申请金额（单位元）。",
"type": "number"
},
"withdrawal_apply_orders": {
"description": "WithdrawalApplyOrders 统计区间内提现申请订单数。",
"type": "integer"
},
"withdrawal_failed_amount": {
"description": "WithdrawalFailedAmount 统计区间内提现失败金额（单位元）。",
"type": "number"
},
"withdrawal_failed_orders": {
"description": "WithdrawalFailedOrders 统计区间内提现失败订单数。",
"type": "integer"
},
"withdrawal_paid_amount": {
"description": "WithdrawalPaidAmount 统计区间内提现完成金额（单位元）。",
"type": "number"
},
"withdrawal_paid_orders": {
"description": "WithdrawalPaidOrders 统计区间内提现完成订单数。",
"type": "integer"
}
}
},
"dto.Settings": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"bio": {
"description": "Bio 频道简介。",
"type": "string"
},
"cover": {
"description": "Cover 封面图URL。",
"type": "string"
},
"description": {
"description": "Description 详细描述。",
"type": "string"
},
"id": {
"description": "ID 租户/频道ID。",
"type": "integer"
},
"name": {
"description": "Name 频道名称。",
"type": "string"
}
}
},
"dto.Stats": {
"type": "object",
"properties": {
"contents": {
"description": "Contents 内容数。",
"type": "integer"
},
"followers": {
"description": "Followers 粉丝数。",
"type": "integer"
},
"likes": {
"description": "Likes 累计点赞数。",
"type": "integer"
}
}
},
"dto.SuperAssetItem": {
"type": "object",
"properties": {
"bucket": {
"description": "Bucket 存储桶名称。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"filename": {
"description": "Filename 原始文件名。",
"type": "string"
},
"hash": {
"description": "Hash 文件哈希（MD5）。",
"type": "string"
},
"id": {
"description": "ID 资产ID。",
"type": "integer"
},
"object_key": {
"description": "ObjectKey 对象Key。",
"type": "string"
},
"provider": {
"description": "Provider 存储提供方。",
"type": "string"
},
"size": {
"description": "Size 文件大小（字节）。",
"type": "integer"
},
"source_asset_id": {
"description": "SourceAssetID 源资产ID（用于变体关联）。",
"type": "integer"
},
"status": {
"description": "Status 处理状态。",
"allOf": [
{
"$ref": "#/definitions/consts.MediaAssetStatus"
}
]
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"type": {
"description": "Type 媒体类型。",
"allOf": [
{
"$ref": "#/definitions/consts.MediaAssetType"
}
]
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"url": {
"description": "URL 访问URL（若可用）。",
"type": "string"
},
"used_count": {
"description": "UsedCount 被内容引用次数。",
"type": "integer"
},
"user_id": {
"description": "UserID 上传用户ID。",
"type": "integer"
},
"username": {
"description": "Username 上传用户名/昵称。",
"type": "string"
},
"variant": {
"description": "Variant 媒体变体（main/preview/cover 等）。",
"allOf": [
{
"$ref": "#/definitions/consts.MediaAssetVariant"
}
]
}
}
},
"dto.SuperAssetUsageItem": {
"type": "object",
"properties": {
"count": {
"description": "Count 该类型资产数量。",
"type": "integer"
},
"total_size": {
"description": "TotalSize 该类型资产大小总和（字节）。",
"type": "integer"
},
"type": {
"description": "Type 媒体类型。",
"allOf": [
{
"$ref": "#/definitions/consts.MediaAssetType"
}
]
}
}
},
"dto.SuperAssetUsageResponse": {
"type": "object",
"properties": {
"by_type": {
"description": "ByType 按媒体类型汇总的用量统计。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperAssetUsageItem"
}
},
"total_count": {
"description": "TotalCount 资产总量。",
"type": "integer"
},
"total_size": {
"description": "TotalSize 资产总大小（字节）。",
"type": "integer"
}
}
},
"dto.SuperAuditLogItem": {
"type": "object",
"properties": {
"action": {
"description": "Action 动作标识。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"detail": {
"description": "Detail 操作详情。",
"type": "string"
},
"id": {
"description": "ID 审计日志ID。",
"type": "integer"
},
"operator_id": {
"description": "OperatorID 操作者用户ID。",
"type": "integer"
},
"operator_name": {
"description": "OperatorName 操作者用户名/昵称。",
"type": "string"
},
"target_id": {
"description": "TargetID 目标ID。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
}
}
},
"dto.SuperBalanceAnomalyItem": {
"type": "object",
"properties": {
"balance": {
"description": "Balance 可用余额（分）。",
"type": "integer"
},
"balance_frozen": {
"description": "BalanceFrozen 冻结余额（分）。",
"type": "integer"
},
"created_at": {
"description": "CreatedAt 用户创建时间（RFC3339）。",
"type": "string"
},
"issue": {
"description": "Issue 异常类型标识。",
"type": "string"
},
"issue_description": {
"description": "IssueDescription 异常描述说明。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.SuperCommentDeleteForm": {
"type": "object",
"properties": {
"reason": {
"description": "Reason 删除原因（可选，用于审计记录）。",
"type": "string"
}
}
},
"dto.SuperCommentItem": {
"type": "object",
"properties": {
"content": {
"description": "Content 评论内容。",
"type": "string"
},
"content_id": {
"description": "ContentID 内容ID。",
"type": "integer"
},
"content_title": {
"description": "ContentTitle 内容标题。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"deleted_at": {
"description": "DeletedAt 删除时间（RFC3339，未删除为空）。",
"type": "string"
},
"id": {
"description": "ID 评论ID。",
"type": "integer"
},
"is_deleted": {
"description": "IsDeleted 是否已删除。",
"type": "boolean"
},
"likes": {
"description": "Likes 评论点赞数。",
"type": "integer"
},
"reply_to": {
"description": "ReplyTo 回复评论ID（0 表示一级评论）。",
"type": "integer"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"user_id": {
"description": "UserID 评论用户ID。",
"type": "integer"
},
"username": {
"description": "Username 评论用户名称。",
"type": "string"
}
}
},
"dto.SuperContentBatchReviewForm": {
"type": "object",
"required": [
"action",
"content_ids"
],
"properties": {
"action": {
"description": "Action 审核动作（approve/reject）。",
"type": "string",
"enum": [
"approve",
"reject"
]
},
"content_ids": {
"description": "ContentIDs 待审核内容ID列表。",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
}
},
"reason": {
"description": "Reason 审核说明（驳回时填写，便于作者修正）。",
"type": "string"
}
}
},
"dto.SuperContentBatchStatusForm": {
"type": "object",
"required": [
"content_ids",
"status"
],
"properties": {
"content_ids": {
"description": "ContentIDs 待处置内容ID列表。",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
}
},
"reason": {
"description": "Reason 处置说明（可选，用于审计与通知作者）。",
"type": "string"
},
"status": {
"description": "Status 目标内容状态（unpublished/blocked）。",
"enum": [
"unpublished",
"blocked"
],
"allOf": [
{
"$ref": "#/definitions/consts.ContentStatus"
}
]
}
}
},
"dto.SuperContentReportBatchProcessForm": {
"type": "object",
"required": [
"action",
"report_ids"
],
"properties": {
"action": {
"description": "Action 处理动作（approve/reject）。",
"type": "string",
"enum": [
"approve",
"reject"
]
},
"content_action": {
"description": "ContentAction 内容处置动作（block/unpublish/ignore），仅在 approve 时生效。",
"type": "string"
},
"reason": {
"description": "Reason 处理说明（可选，用于审计记录）。",
"type": "string"
},
"report_ids": {
"description": "ReportIDs 待处理举报ID列表。",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
}
}
}
},
"dto.SuperContentReportItem": {
"type": "object",
"properties": {
"content_id": {
"description": "ContentID 内容ID。",
"type": "integer"
},
"content_owner_id": {
"description": "ContentOwnerID 内容作者用户ID。",
"type": "integer"
},
"content_owner_name": {
"description": "ContentOwnerName 内容作者用户名/昵称。",
"type": "string"
},
"content_status": {
"description": "ContentStatus 内容状态。",
"type": "string"
},
"content_title": {
"description": "ContentTitle 内容标题。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 举报时间（RFC3339）。",
"type": "string"
},
"detail": {
"description": "Detail 举报描述。",
"type": "string"
},
"handled_action": {
"description": "HandledAction 处理动作（block/unpublish/ignore）。",
"type": "string"
},
"handled_at": {
"description": "HandledAt 处理时间（RFC3339）。",
"type": "string"
},
"handled_by": {
"description": "HandledBy 处理人用户ID。",
"type": "integer"
},
"handled_by_name": {
"description": "HandledByName 处理人用户名/昵称。",
"type": "string"
},
"handled_reason": {
"description": "HandledReason 处理说明。",
"type": "string"
},
"id": {
"description": "ID 举报ID。",
"type": "integer"
},
"reason": {
"description": "Reason 举报原因。",
"type": "string"
},
"reporter_id": {
"description": "ReporterID 举报人用户ID。",
"type": "integer"
},
"reporter_name": {
"description": "ReporterName 举报人用户名/昵称。",
"type": "string"
},
"status": {
"description": "Status 处理状态。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
}
}
},
"dto.SuperContentReportProcessForm": {
"type": "object",
"properties": {
"action": {
"description": "Action 处理动作（approve/reject）。",
"type": "string"
},
"content_action": {
"description": "ContentAction 内容处置动作（block/unpublish/ignore），仅在 approve 时生效。",
"type": "string"
},
"reason": {
"description": "Reason 处理说明（可选，用于审计记录）。",
"type": "string"
}
}
},
"dto.SuperContentReviewForm": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"description": "Action 审核动作（approve/reject）。",
"type": "string",
"enum": [
"approve",
"reject"
]
},
"reason": {
"description": "Reason 审核说明（驳回时填写，便于作者修正）。",
"type": "string"
}
}
},
"dto.SuperContentStatisticsResponse": {
"type": "object",
"properties": {
"total_count": {
"description": "TotalCount 内容总量。",
"type": "integer"
},
"trend": {
"description": "Trend 按天新增内容趋势。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperContentTrendItem"
}
}
}
},
"dto.SuperContentTenantLite": {
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
}
}
},
"dto.SuperContentTrendItem": {
"type": "object",
"properties": {
"created_count": {
"description": "CreatedCount 当日新增内容数量。",
"type": "integer"
},
"date": {
"description": "Date 日期（YYYY-MM-DD）。",
"type": "string"
}
}
},
"dto.SuperCouponGrantItem": {
"type": "object",
"properties": {
"coupon_id": {
"description": "CouponID 优惠券ID。",
"type": "integer"
},
"coupon_title": {
"description": "CouponTitle 优惠券标题。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 领取时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 用户券ID。",
"type": "integer"
},
"order_id": {
"description": "OrderID 使用订单ID。",
"type": "integer"
},
"status": {
"description": "Status 用户券状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserCouponStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"used_at": {
"description": "UsedAt 使用时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.SuperCouponGrantResponse": {
"type": "object",
"properties": {
"granted": {
"description": "Granted 实际发放数量。",
"type": "integer"
}
}
},
"dto.SuperCouponItem": {
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"description": {
"description": "Description 优惠券描述。",
"type": "string"
},
"end_at": {
"description": "EndAt 结束时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 优惠券ID。",
"type": "integer"
},
"max_discount": {
"description": "MaxDiscount 最大折扣金额（折扣券）。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 最低订单金额门槛。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339）。",
"type": "string"
},
"status": {
"description": "Status 状态（active/expired/upcoming）。",
"type": "string"
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"title": {
"description": "Title 优惠券标题。",
"type": "string"
},
"total_quantity": {
"description": "TotalQuantity 总发行数量（0 表示不限量）。",
"type": "integer"
},
"type": {
"description": "Type 优惠券类型。",
"allOf": [
{
"$ref": "#/definitions/consts.CouponType"
}
]
},
"type_description": {
"description": "TypeDescription 类型描述（用于展示）。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"used_quantity": {
"description": "UsedQuantity 已使用数量。",
"type": "integer"
},
"value": {
"description": "Value 优惠券面额/折扣值。",
"type": "integer"
}
}
},
"dto.SuperCouponRiskItem": {
"type": "object",
"properties": {
"coupon_id": {
"description": "CouponID 优惠券ID。",
"type": "integer"
},
"coupon_title": {
"description": "CouponTitle 优惠券标题。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 领取时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 用户券ID。",
"type": "integer"
},
"order_amount_paid": {
"description": "OrderAmountPaid 订单实付金额（分）。",
"type": "integer"
},
"order_id": {
"description": "OrderID 使用订单ID。",
"type": "integer"
},
"order_status": {
"description": "OrderStatus 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"order_status_description": {
"description": "OrderStatusDescription 订单状态描述（用于展示）。",
"type": "string"
},
"paid_at": {
"description": "PaidAt 订单支付时间（RFC3339）。",
"type": "string"
},
"risk_reason": {
"description": "RiskReason 异常说明。",
"type": "string"
},
"risk_type": {
"description": "RiskType 异常类型。",
"type": "string"
},
"status": {
"description": "Status 用户券状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserCouponStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"used_at": {
"description": "UsedAt 使用时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.SuperCouponStatusUpdateForm": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"description": "Status 目标状态（frozen）。",
"type": "string",
"enum": [
"frozen"
]
}
}
},
"dto.SuperCreatorApplicationReviewForm": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"description": "Action 审核动作（approve/reject）。",
"type": "string",
"enum": [
"approve",
"reject"
]
},
"reason": {
"description": "Reason 审核说明（可选，驳回时填写）。",
"type": "string"
}
}
},
"dto.SuperHealthAlertItem": {
"type": "object",
"properties": {
"count": {
"description": "Count 关联数量（例如失败数、超时数）。",
"type": "integer"
},
"detail": {
"description": "Detail 告警详情说明。",
"type": "string"
},
"kind": {
"description": "Kind 告警类型（order_error_rate/upload_error_rate/upload_stuck/tenant_health）。",
"type": "string"
},
"level": {
"description": "Level 告警级别（warning/risk）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 关联租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 关联租户ID（无则为 0）。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 关联租户名称。",
"type": "string"
},
"title": {
"description": "Title 告警标题。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 告警更新时间（RFC3339）。",
"type": "string"
}
}
},
"dto.SuperHealthOverviewResponse": {
"type": "object",
"properties": {
"alerts": {
"description": "Alerts 健康告警列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperHealthAlertItem"
}
},
"end_at": {
"description": "EndAt 统计结束时间（RFC3339）。",
"type": "string"
},
"order_failed": {
"description": "OrderFailed 失败订单数（统计区间内）。",
"type": "integer"
},
"order_failed_rate": {
"description": "OrderFailedRate 失败率（失败订单数 / 总订单数）。",
"type": "number"
},
"order_total": {
"description": "OrderTotal 订单总数（统计区间内）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 统计开始时间（RFC3339）。",
"type": "string"
},
"storage_total_count": {
"description": "StorageTotalCount 资产总量（全量）。",
"type": "integer"
},
"storage_total_size": {
"description": "StorageTotalSize 资产总大小（字节，全量）。",
"type": "integer"
},
"tenant_id": {
"description": "TenantID 当前统计的租户ID（0 代表全平台）。",
"type": "integer"
},
"tenant_risk_count": {
"description": "TenantRiskCount 健康风险租户数。",
"type": "integer"
},
"tenant_total": {
"description": "TenantTotal 租户总数。",
"type": "integer"
},
"tenant_warning_count": {
"description": "TenantWarningCount 健康预警租户数。",
"type": "integer"
},
"upload_failed": {
"description": "UploadFailed 上传失败资产数（统计区间内）。",
"type": "integer"
},
"upload_failed_rate": {
"description": "UploadFailedRate 上传失败率（失败资产数 / 总资产数）。",
"type": "number"
},
"upload_processing_stuck": {
"description": "UploadProcessingStuck 处理超时资产数（processing 且超时）。",
"type": "integer"
},
"upload_stuck_hours": {
"description": "UploadStuckHours 上传处理超时时长（小时）。",
"type": "integer"
},
"upload_total": {
"description": "UploadTotal 上传资产总数（统计区间内）。",
"type": "integer"
},
"upload_uploaded_stuck": {
"description": "UploadUploadedStuck 已上传但未进入处理的超时资产数（uploaded 且超时）。",
"type": "integer"
}
}
},
"dto.SuperLedgerItem": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 变动金额（分）。",
"type": "integer"
},
"balance_after": {
"description": "BalanceAfter 变更后可用余额（分）。",
"type": "integer"
},
"balance_before": {
"description": "BalanceBefore 变更前可用余额（分）。",
"type": "integer"
},
"biz_ref_id": {
"description": "BizRefID 业务引用ID（可选）。",
"type": "integer"
},
"biz_ref_type": {
"description": "BizRefType 业务引用类型（可选）。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"frozen_after": {
"description": "FrozenAfter 变更后冻结余额（分）。",
"type": "integer"
},
"frozen_before": {
"description": "FrozenBefore 变更前冻结余额（分）。",
"type": "integer"
},
"id": {
"description": "ID 流水ID。",
"type": "integer"
},
"operator_user_id": {
"description": "OperatorUserID 操作者用户ID（0 表示系统）。",
"type": "integer"
},
"order_id": {
"description": "OrderID 关联订单ID。",
"type": "integer"
},
"remark": {
"description": "Remark 流水备注说明。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"type": {
"description": "Type 流水类型。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantLedgerType"
}
]
},
"type_description": {
"description": "TypeDescription 流水类型描述（用于展示）。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 关联用户ID。",
"type": "integer"
},
"username": {
"description": "Username 关联用户名。",
"type": "string"
}
}
},
"dto.SuperNotificationBroadcastForm": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID（选填，用于指定租户成员）。",
"type": "integer"
},
"title": {
"description": "Title 通知标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型（system/order/audit/interaction）。",
"allOf": [
{
"$ref": "#/definitions/consts.NotificationType"
}
]
},
"user_ids": {
"description": "UserIDs 指定接收用户ID列表（优先级高于 TenantID）。",
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"dto.SuperNotificationItem": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 通知ID。",
"type": "integer"
},
"is_read": {
"description": "IsRead 是否已读。",
"type": "boolean"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"title": {
"description": "Title 通知标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型。",
"allOf": [
{
"$ref": "#/definitions/consts.NotificationType"
}
]
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名/昵称。",
"type": "string"
}
}
},
"dto.SuperNotificationTemplateCreateForm": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容。",
"type": "string"
},
"is_active": {
"description": "IsActive 是否启用（不传默认启用）。",
"type": "boolean"
},
"name": {
"description": "Name 模板名称（用于识别用途）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID（不传代表全平台模板）。",
"type": "integer"
},
"title": {
"description": "Title 通知标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型（system/order/audit/interaction）。",
"allOf": [
{
"$ref": "#/definitions/consts.NotificationType"
}
]
}
}
},
"dto.SuperNotificationTemplateItem": {
"type": "object",
"properties": {
"content": {
"description": "Content 模板内容。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 模板ID。",
"type": "integer"
},
"is_active": {
"description": "IsActive 是否启用。",
"type": "boolean"
},
"name": {
"description": "Name 模板名称。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"title": {
"description": "Title 模板标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型。",
"allOf": [
{
"$ref": "#/definitions/consts.NotificationType"
}
]
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
}
}
},
"dto.SuperNotificationTemplateUpdateForm": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容（可选）。",
"type": "string"
},
"is_active": {
"description": "IsActive 是否启用（可选）。",
"type": "boolean"
},
"name": {
"description": "Name 模板名称（可选）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID（不传代表不修改租户归属）。",
"type": "integer"
},
"title": {
"description": "Title 通知标题（可选）。",
"type": "string"
},
"type": {
"description": "Type 通知类型（system/order/audit/interaction，可选）。",
"allOf": [
{
"$ref": "#/definitions/consts.NotificationType"
}
]
}
}
},
"dto.SuperOrderAnomalyItem": {
"type": "object",
"properties": {
"amount_paid": {
"description": "AmountPaid 实付金额（分）。",
"type": "integer"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"issue": {
"description": "Issue 异常类型标识。",
"type": "string"
},
"issue_description": {
"description": "IssueDescription 异常描述说明。",
"type": "string"
},
"order_id": {
"description": "OrderID 订单ID。",
"type": "integer"
},
"paid_at": {
"description": "PaidAt 支付时间（RFC3339）。",
"type": "string"
},
"refunded_at": {
"description": "RefundedAt 退款时间（RFC3339）。",
"type": "string"
},
"status": {
"description": "Status 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"type": {
"description": "Type 订单类型。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderType"
}
]
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.SuperOrderDetail": {
"type": "object",
"properties": {
"buyer": {
"description": "Buyer 订单买家信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderBuyerLite"
}
]
},
"order": {
"description": "Order 订单详细信息。",
"allOf": [
{
"$ref": "#/definitions/dto.SuperOrderItem"
}
]
},
"tenant": {
"description": "Tenant 订单所属租户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderTenantLite"
}
]
}
}
},
"dto.SuperOrderFlagForm": {
"type": "object",
"properties": {
"is_flagged": {
"description": "IsFlagged 是否标记为问题订单。",
"type": "boolean"
},
"reason": {
"description": "Reason 标记原因（标记为问题时必填）。",
"type": "string"
}
}
},
"dto.SuperOrderItem": {
"type": "object",
"properties": {
"amount_discount": {
"description": "AmountDiscount 优惠金额（分）。",
"type": "integer"
},
"amount_original": {
"description": "AmountOriginal 原价金额（分）。",
"type": "integer"
},
"amount_paid": {
"description": "AmountPaid 实付金额（分）。",
"type": "integer"
},
"buyer": {
"description": "Buyer 订单买家信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderBuyerLite"
}
]
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"currency": {
"description": "Currency 币种。",
"allOf": [
{
"$ref": "#/definitions/consts.Currency"
}
]
},
"flag_reason": {
"description": "FlagReason 问题标记原因。",
"type": "string"
},
"flagged_at": {
"description": "FlaggedAt 标记时间（RFC3339）。",
"type": "string"
},
"flagged_by": {
"description": "FlaggedBy 标记操作者ID。",
"type": "integer"
},
"id": {
"description": "ID 订单ID。",
"type": "integer"
},
"is_flagged": {
"description": "IsFlagged 是否标记为问题订单。",
"type": "boolean"
},
"is_reconciled": {
"description": "IsReconciled 是否完成对账。",
"type": "boolean"
},
"items": {
"description": "Items 订单明细行，用于展示具体内容与金额拆分。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperOrderItemLine"
}
},
"paid_at": {
"description": "PaidAt 支付时间（RFC3339）。",
"type": "string"
},
"reconcile_note": {
"description": "ReconcileNote 对账说明。",
"type": "string"
},
"reconciled_at": {
"description": "ReconciledAt 对账时间（RFC3339）。",
"type": "string"
},
"reconciled_by": {
"description": "ReconciledBy 对账操作者ID。",
"type": "integer"
},
"refunded_at": {
"description": "RefundedAt 退款时间（RFC3339）。",
"type": "string"
},
"snapshot": {
"description": "Snapshot 订单快照，包含下单时的关键参数与定价信息，便于审计回溯。"
},
"status": {
"description": "Status 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant": {
"description": "Tenant 订单所属租户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderTenantLite"
}
]
},
"type": {
"description": "Type 订单类型。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderType"
}
]
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
}
}
},
"dto.SuperOrderItemLine": {
"type": "object",
"properties": {
"amount_paid": {
"description": "AmountPaid 该明细实付金额（分）。",
"type": "integer"
},
"content_id": {
"description": "ContentID 购买的内容ID。",
"type": "integer"
},
"id": {
"description": "ID 订单明细ID。",
"type": "integer"
},
"snapshot": {
"description": "Snapshot 明细快照，用于展示内容标题等历史信息。"
}
}
},
"dto.SuperOrderReconcileForm": {
"type": "object",
"properties": {
"is_reconciled": {
"description": "IsReconciled 是否完成对账。",
"type": "boolean"
},
"note": {
"description": "Note 对账说明（可选）。",
"type": "string"
}
}
},
"dto.SuperOrderRefundForm": {
"type": "object",
"properties": {
"force": {
"description": "Force 是否强制退款（忽略部分约束）。",
"type": "boolean"
},
"idempotency_key": {
"description": "IdempotencyKey 幂等键（防止重复提交）。",
"type": "string"
},
"reason": {
"description": "Reason 退款原因说明。",
"type": "string"
}
}
},
"dto.SuperPayoutAccountCreateForm": {
"type": "object",
"required": [
"account",
"name",
"realname",
"type",
"user_id"
],
"properties": {
"account": {
"description": "Account 收款账号。",
"type": "string",
"maxLength": 128
},
"name": {
"description": "Name 账户名称/开户行。",
"type": "string",
"maxLength": 128
},
"realname": {
"description": "Realname 收款人姓名。",
"type": "string",
"maxLength": 128
},
"type": {
"description": "Type 账户类型（bank/alipay）。",
"type": "string",
"enum": [
"bank",
"alipay"
]
},
"user_id": {
"description": "UserID 收款账户归属用户ID。",
"type": "integer"
}
}
},
"dto.SuperPayoutAccountItem": {
"type": "object",
"properties": {
"account": {
"description": "Account 收款账号。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 结算账户ID。",
"type": "integer"
},
"name": {
"description": "Name 账户名称/开户行。",
"type": "string"
},
"realname": {
"description": "Realname 收款人姓名。",
"type": "string"
},
"review_reason": {
"description": "ReviewReason 审核说明/驳回原因。",
"type": "string"
},
"reviewed_at": {
"description": "ReviewedAt 审核时间（RFC3339）。",
"type": "string"
},
"reviewed_by": {
"description": "ReviewedBy 审核操作者ID。",
"type": "integer"
},
"status": {
"description": "Status 审核状态。",
"allOf": [
{
"$ref": "#/definitions/consts.PayoutAccountStatus"
}
]
},
"status_description": {
"description": "StatusDescription 审核状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"type": {
"description": "Type 账户类型。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.SuperPayoutAccountReviewForm": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"description": "Action 审核动作（approve/reject）。",
"type": "string",
"enum": [
"approve",
"reject"
]
},
"reason": {
"description": "Reason 审核说明（驳回时必填）。",
"type": "string"
}
}
},
"dto.SuperPayoutAccountUpdateForm": {
"type": "object",
"properties": {
"account": {
"description": "Account 收款账号（可选）。",
"type": "string",
"maxLength": 128
},
"name": {
"description": "Name 账户名称/开户行（可选）。",
"type": "string",
"maxLength": 128
},
"realname": {
"description": "Realname 收款人姓名（可选）。",
"type": "string",
"maxLength": 128
},
"type": {
"description": "Type 账户类型（bank/alipay，可选）。",
"type": "string",
"enum": [
"bank",
"alipay"
]
}
}
},
"dto.SuperReportExportForm": {
"type": "object",
"properties": {
"end_at": {
"description": "EndAt 统计结束时间（RFC3339，可选；默认当前时间）。",
"type": "string"
},
"format": {
"description": "Format 导出格式（仅支持 csv）。",
"type": "string"
},
"granularity": {
"description": "Granularity 统计粒度（day；目前仅支持 day）。",
"type": "string"
},
"start_at": {
"description": "StartAt 统计开始时间（RFC3339，可选；默认当前时间往前 7 天）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID（不传代表全平台）。",
"type": "integer"
}
}
},
"dto.SuperSystemConfigCreateForm": {
"type": "object",
"properties": {
"config_key": {
"description": "ConfigKey 配置项Key（唯一）。",
"type": "string"
},
"description": {
"description": "Description 配置说明。",
"type": "string"
},
"value": {
"description": "Value 配置值（JSON）。",
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"dto.SuperSystemConfigItem": {
"type": "object",
"properties": {
"config_key": {
"description": "ConfigKey 配置项Key。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"description": {
"description": "Description 配置说明。",
"type": "string"
},
"id": {
"description": "ID 配置ID。",
"type": "integer"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"value": {
"description": "Value 配置值（JSON）。",
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"dto.SuperSystemConfigUpdateForm": {
"type": "object",
"properties": {
"description": {
"description": "Description 配置说明（可选）。",
"type": "string"
},
"value": {
"description": "Value 配置值（JSON，可选）。",
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"dto.SuperTenantContentStatusUpdateForm": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"description": "Status 目标内容状态。",
"enum": [
"unpublished",
"blocked"
],
"allOf": [
{
"$ref": "#/definitions/consts.ContentStatus"
}
]
}
}
},
"dto.SuperTenantJoinRequestItem": {
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 申请时间（RFC3339）。",
"type": "string"
},
"decided_at": {
"description": "DecidedAt 审核时间（RFC3339）。",
"type": "string"
},
"decided_operator_user_id": {
"description": "DecidedOperatorUserID 审核操作者ID。",
"type": "integer"
},
"decided_reason": {
"description": "DecidedReason 审核备注/原因。",
"type": "string"
},
"id": {
"description": "ID 申请记录ID。",
"type": "integer"
},
"reason": {
"description": "Reason 申请说明。",
"type": "string"
},
"status": {
"description": "Status 申请状态。",
"type": "string"
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 申请用户ID。",
"type": "integer"
},
"username": {
"description": "Username 申请用户名称。",
"type": "string"
}
}
},
"dto.SuperTenantUserItem": {
"type": "object",
"properties": {
"tenant_user": {
"description": "TenantUser 租户成员关系信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantUser"
}
]
},
"user": {
"description": "User 用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.SuperUserLite"
}
]
}
}
},
"dto.SuperUserContentActionItem": {
"type": "object",
"properties": {
"action_at": {
"description": "ActionAt 互动发生时间（RFC3339）。",
"type": "string"
},
"action_id": {
"description": "ActionID 互动记录ID。",
"type": "integer"
},
"action_type": {
"description": "ActionType 互动类型（like/favorite）。",
"allOf": [
{
"$ref": "#/definitions/consts.UserContentActionType"
}
]
},
"content": {
"description": "Content 互动对应内容详情（含租户与作者信息）。",
"allOf": [
{
"$ref": "#/definitions/dto.AdminContentItem"
}
]
}
}
},
"dto.SuperUserCouponItem": {
"type": "object",
"properties": {
"coupon_id": {
"description": "CouponID 券模板ID。",
"type": "integer"
},
"created_at": {
"description": "CreatedAt 领取时间（RFC3339）。",
"type": "string"
},
"description": {
"description": "Description 券描述。",
"type": "string"
},
"end_at": {
"description": "EndAt 过期时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 用户券ID。",
"type": "integer"
},
"max_discount": {
"description": "MaxDiscount 折扣券最高抵扣金额（分）。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 使用门槛金额（分）。",
"type": "integer"
},
"order_id": {
"description": "OrderID 使用订单ID（未使用为0）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339）。",
"type": "string"
},
"status": {
"description": "Status 用户券状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserCouponStatus"
}
]
},
"status_description": {
"description": "StatusDescription 用户券状态描述（用于展示）。",
"type": "string"
},
"tenant_code": {
"description": "TenantCode 券所属租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 券所属租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 券所属租户名称。",
"type": "string"
},
"title": {
"description": "Title 券标题。",
"type": "string"
},
"type": {
"description": "Type 券类型。",
"allOf": [
{
"$ref": "#/definitions/consts.CouponType"
}
]
},
"type_description": {
"description": "TypeDescription 券类型描述（用于展示）。",
"type": "string"
},
"used_at": {
"description": "UsedAt 使用时间（RFC3339）。",
"type": "string"
},
"value": {
"description": "Value 券面值/折扣值。",
"type": "integer"
}
}
},
"dto.SuperUserLibraryItem": {
"type": "object",
"properties": {
"access_id": {
"description": "AccessID 访问记录ID。",
"type": "integer"
},
"access_status": {
"description": "AccessStatus 访问状态。",
"allOf": [
{
"$ref": "#/definitions/consts.ContentAccessStatus"
}
]
},
"access_status_description": {
"description": "AccessStatusDescription 访问状态描述（用于展示）。",
"type": "string"
},
"accessed_at": {
"description": "AccessedAt 获取访问权限时间（RFC3339）。",
"type": "string"
},
"amount_paid": {
"description": "AmountPaid 该内容实付金额（分）。",
"type": "integer"
},
"content": {
"description": "Content 内容详情（含租户/作者/价格）。",
"allOf": [
{
"$ref": "#/definitions/dto.AdminContentItem"
}
]
},
"content_id": {
"description": "ContentID 内容ID。",
"type": "integer"
},
"order_id": {
"description": "OrderID 订单ID。",
"type": "integer"
},
"order_status": {
"description": "OrderStatus 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"order_status_description": {
"description": "OrderStatusDescription 订单状态描述（用于展示）。",
"type": "string"
},
"order_type": {
"description": "OrderType 订单类型。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderType"
}
]
},
"paid_at": {
"description": "PaidAt 支付时间（RFC3339）。",
"type": "string"
},
"snapshot": {
"description": "Snapshot 下单快照（内容标题/金额等）。"
},
"tenant_id": {
"description": "TenantID 内容所属租户ID。",
"type": "integer"
}
}
},
"dto.SuperUserLite": {
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"username": {
"description": "Username 用户名（用于识别/展示）。",
"type": "string"
},
"verified_at": {
"description": "VerifiedAt 实名认证时间（RFC3339）。",
"type": "string"
}
}
},
"dto.SuperUserNotificationItem": {
"type": "object",
"properties": {
"content": {
"description": "Content 通知内容。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 发送时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 通知ID。",
"type": "integer"
},
"read": {
"description": "Read 是否已读。",
"type": "boolean"
},
"tenant_code": {
"description": "TenantCode 通知所属租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 通知所属租户ID。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 通知所属租户名称。",
"type": "string"
},
"title": {
"description": "Title 通知标题。",
"type": "string"
},
"type": {
"description": "Type 通知类型。",
"type": "string"
}
}
},
"dto.SuperUserProfileUpdateForm": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL（可选，空字符串表示清空）。",
"type": "string"
},
"bio": {
"description": "Bio 个人简介（可选，空字符串表示清空）。",
"type": "string"
},
"gender": {
"description": "Gender 性别（可选）。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"id_card": {
"description": "IDCard 身份证号（可选，用于更新实名认证信息）。",
"type": "string"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否已实名认证（可选）。",
"type": "boolean"
},
"nickname": {
"description": "Nickname 昵称（可选，空字符串表示清空）。",
"type": "string"
},
"real_name": {
"description": "RealName 真实姓名（可选，用于更新实名认证信息）。",
"type": "string"
}
}
},
"dto.SuperUserRealNameResponse": {
"type": "object",
"properties": {
"id_card_masked": {
"description": "IDCardMasked 身份证号脱敏展示。",
"type": "string"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否已实名认证。",
"type": "boolean"
},
"real_name": {
"description": "RealName 真实姓名（来自用户元数据）。",
"type": "string"
},
"verified_at": {
"description": "VerifiedAt 实名认证时间（RFC3339）。",
"type": "string"
}
}
},
"dto.SuperWalletResponse": {
"type": "object",
"properties": {
"balance": {
"description": "Balance 账户可用余额（分）。",
"type": "integer"
},
"balance_frozen": {
"description": "BalanceFrozen 账户冻结余额（分）。",
"type": "integer"
},
"transactions": {
"description": "Transactions 最近交易记录。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperWalletTransaction"
}
}
}
},
"dto.SuperWalletTransaction": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 交易金额（分）。",
"type": "integer"
},
"date": {
"description": "Date 交易时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 订单ID。",
"type": "integer"
},
"order_type": {
"description": "OrderType 订单类型。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderType"
}
]
},
"tenant_code": {
"description": "TenantCode 租户编码。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 交易所属租户ID（充值为0）。",
"type": "integer"
},
"tenant_name": {
"description": "TenantName 租户名称。",
"type": "string"
},
"title": {
"description": "Title 交易标题。",
"type": "string"
},
"type": {
"description": "Type 交易流向（income/expense）。",
"type": "string"
}
}
},
"dto.SuperWithdrawalRejectForm": {
"type": "object",
"required": [
"reason"
],
"properties": {
"reason": {
"description": "Reason 驳回原因。",
"type": "string"
}
}
},
"dto.TenantAdminUserLite": {
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.TenantCreateForm": {
"type": "object",
"required": [
"admin_user_id",
"code",
"duration",
"name"
],
"properties": {
"admin_user_id": {
"description": "AdminUserID 租户管理员用户ID。",
"type": "integer"
},
"code": {
"description": "Code 租户编码（唯一）。",
"type": "string",
"maxLength": 64
},
"duration": {
"description": "Duration 租户有效期（天）。",
"type": "integer",
"enum": [
7,
30,
90,
180,
365
]
},
"name": {
"description": "Name 租户名称。",
"type": "string",
"maxLength": 128
}
}
},
"dto.TenantExpireUpdateForm": {
"type": "object",
"required": [
"duration"
],
"properties": {
"duration": {
"description": "Duration 延长有效期（天）。",
"type": "integer",
"enum": [
7,
30,
90,
180,
365
]
}
}
},
"dto.TenantHealthItem": {
"type": "object",
"properties": {
"alerts": {
"description": "Alerts 异常提示列表（用于运营侧提示）。",
"type": "array",
"items": {
"type": "string"
}
},
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"content_count": {
"description": "ContentCount 内容总数。",
"type": "integer"
},
"health_level": {
"description": "HealthLevel 健康等级（healthy/warning/risk）。",
"type": "string"
},
"last_paid_at": {
"description": "LastPaidAt 最近成交时间（RFC3339，空代表暂无成交）。",
"type": "string"
},
"member_count": {
"description": "MemberCount 租户成员数量（包含管理员）。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"owner": {
"description": "Owner 租户所有者信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantOwnerUserLite"
}
]
},
"paid_amount": {
"description": "PaidAmount 已支付金额（分）。",
"type": "integer"
},
"paid_orders": {
"description": "PaidOrders 已支付订单数（内容购买）。",
"type": "integer"
},
"published_content_count": {
"description": "PublishedContentCount 已发布内容数量。",
"type": "integer"
},
"refund_amount": {
"description": "RefundAmount 已退款金额（分）。",
"type": "integer"
},
"refund_orders": {
"description": "RefundOrders 已退款订单数（内容购买）。",
"type": "integer"
},
"refund_rate": {
"description": "RefundRate 退款率（退款订单数 / 已支付订单数）。",
"type": "number"
},
"status": {
"description": "Status 租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
},
"status_description": {
"description": "StatusDescription 租户状态描述（用于展示）。",
"type": "string"
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
}
}
},
"dto.TenantInviteAcceptForm": {
"type": "object",
"properties": {
"code": {
"description": "Code 邀请码（必填）。",
"type": "string"
}
}
},
"dto.TenantInviteCreateForm": {
"type": "object",
"properties": {
"expires_at": {
"description": "ExpiresAt 过期时间（RFC3339，可选，空值使用默认过期时间）。",
"type": "string"
},
"max_uses": {
"description": "MaxUses 最大可使用次数（\u003c=0 默认 1）。",
"type": "integer"
},
"remark": {
"description": "Remark 备注说明（可选）。",
"type": "string"
}
}
},
"dto.TenantInviteItem": {
"type": "object",
"properties": {
"code": {
"description": "Code 邀请码。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"expires_at": {
"description": "ExpiresAt 过期时间（RFC3339，空字符串表示不限制）。",
"type": "string"
},
"id": {
"description": "ID 邀请记录ID。",
"type": "integer"
},
"max_uses": {
"description": "MaxUses 最大可使用次数。",
"type": "integer"
},
"remark": {
"description": "Remark 备注说明。",
"type": "string"
},
"status": {
"description": "Status 邀请状态（active/disabled/expired）。",
"type": "string"
},
"used_count": {
"description": "UsedCount 已使用次数。",
"type": "integer"
}
}
},
"dto.TenantItem": {
"type": "object",
"properties": {
"admin_users": {
"description": "AdminUsers 租户管理员列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantAdminUserLite"
}
},
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"config": {
"description": "Config 租户配置项（占位/需要结构化时替换）。",
"type": "array",
"items": {
"type": "integer"
}
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"expired_at": {
"description": "ExpiredAt 租户过期时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"income_amount_paid_sum": {
"description": "IncomeAmountPaidSum 累计实收金额（分）。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"owner": {
"description": "Owner 租户所有者信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantOwnerUserLite"
}
]
},
"status": {
"description": "Status 租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
},
"status_description": {
"description": "StatusDescription 租户状态描述。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"user_count": {
"description": "UserCount 租户成员数量。",
"type": "integer"
},
"user_id": {
"description": "UserID 创建者用户ID。",
"type": "integer"
},
"users": {
"description": "Users 租户成员列表（用于详情展示）。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserLite"
}
},
"uuid": {
"description": "UUID 租户UUID。",
"type": "string"
}
}
},
"dto.TenantJoinReviewForm": {
"type": "object",
"properties": {
"action": {
"description": "Action 审核动作（approve/reject）。",
"type": "string"
},
"reason": {
"description": "Reason 审核说明（可选，用于展示驳回原因或备注）。",
"type": "string"
}
}
},
"dto.TenantOwnerUserLite": {
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
},
"dto.TenantProfile": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"bio": {
"description": "Bio 简短简介。",
"type": "string"
},
"cert_type": {
"description": "CertType 认证类型（personal/enterprise）。",
"type": "string"
},
"cover": {
"description": "Cover 封面图URL。",
"type": "string"
},
"description": {
"description": "Description 详细描述。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"is_following": {
"description": "IsFollowing 当前用户是否关注。",
"type": "boolean"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"stats": {
"description": "Stats 统计信息。",
"allOf": [
{
"$ref": "#/definitions/dto.Stats"
}
]
}
}
},
"dto.TenantStatusUpdateForm": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"description": "Status 目标租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
}
}
},
"dto.TenantUser": {
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 成员记录ID。",
"type": "integer"
},
"role": {
"description": "Role 成员角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.TenantUserRole"
}
},
"status": {
"description": "Status 成员状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
}
}
},
"dto.Topic": {
"type": "object",
"properties": {
"count": {
"description": "Count 专题内内容数量。",
"type": "integer"
},
"cover": {
"description": "Cover 专题封面图。",
"type": "string"
},
"id": {
"description": "ID 专题ID。",
"type": "integer"
},
"tag": {
"description": "Tag 专题标签（用于筛选/展示）。",
"type": "string"
},
"title": {
"description": "Title 专题标题。",
"type": "string"
}
}
},
"dto.Transaction": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 发生金额（单位元）。",
"type": "number"
},
"date": {
"description": "Date 发生时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 流水ID。",
"type": "integer"
},
"title": {
"description": "Title 流水标题/描述。",
"type": "string"
},
"type": {
"description": "Type 流水类型（income/expense）。",
"type": "string"
}
}
},
"dto.UploadCompleteForm": {
"type": "object",
"properties": {
"upload_id": {
"description": "UploadID 分片上传ID。",
"type": "string"
}
}
},
"dto.UploadInitForm": {
"type": "object",
"properties": {
"filename": {
"description": "Filename 原始文件名。",
"type": "string"
},
"hash": {
"description": "Hash 文件 MD5 哈希（用于秒传校验）。",
"type": "string"
},
"mime_type": {
"description": "MimeType 文件类型（如 image/png）。",
"type": "string"
},
"size": {
"description": "Size 文件大小（字节）。",
"type": "integer"
},
"type": {
"description": "Type 业务类型（如 cover/media/avatar）。",
"type": "string"
}
}
},
"dto.UploadInitResponse": {
"type": "object",
"properties": {
"chunk_size": {
"description": "ChunkSize 分片大小（字节）。",
"type": "integer"
},
"key": {
"description": "Key 对象存储Key（S3 直传使用）。",
"type": "string"
},
"upload_id": {
"description": "UploadID 分片上传ID。",
"type": "string"
}
}
},
"dto.UploadResult": {
"type": "object",
"properties": {
"filename": {
"description": "Filename 原始文件名。",
"type": "string"
},
"id": {
"description": "ID 媒体资源ID。",
"type": "integer"
},
"mime_type": {
"description": "MimeType 文件类型（如 image/png）。",
"type": "string"
},
"size": {
"description": "Size 文件大小（字节）。",
"type": "integer"
},
"url": {
"description": "URL 访问地址（包含签名或公共URL）。",
"type": "string"
}
}
},
"dto.UserCouponItem": {
"type": "object",
"properties": {
"coupon_id": {
"description": "CouponID 券模板ID。",
"type": "integer"
},
"description": {
"description": "Description 券描述。",
"type": "string"
},
"end_at": {
"description": "EndAt 过期时间（RFC3339）。",
"type": "string"
},
"id": {
"description": "ID 用户券ID。",
"type": "integer"
},
"min_order_amount": {
"description": "MinOrderAmount 使用门槛金额（分）。",
"type": "integer"
},
"start_at": {
"description": "StartAt 生效时间（RFC3339）。",
"type": "string"
},
"status": {
"description": "Status 当前状态（可用/已用/过期）。",
"type": "string"
},
"title": {
"description": "Title 券标题。",
"type": "string"
},
"type": {
"description": "Type 券类型（满减/折扣）。",
"type": "string"
},
"value": {
"description": "Value 券面值（分/百分比）。",
"type": "integer"
}
}
},
"dto.UserItem": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 用户头像URL（资料展示）。",
"type": "string"
},
"balance": {
"description": "Balance 账户可用余额（分）。",
"type": "integer"
},
"balance_frozen": {
"description": "BalanceFrozen 账户冻结余额（分）。",
"type": "integer"
},
"bio": {
"description": "Bio 用户个人简介。",
"type": "string"
},
"created_at": {
"description": "CreatedAt 创建时间（RFC3339）。",
"type": "string"
},
"gender": {
"description": "Gender 用户性别（male/female/secret）。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否已实名认证。",
"type": "boolean"
},
"joined_tenant_count": {
"description": "JoinedTenantCount 加入的租户数量。",
"type": "integer"
},
"nickname": {
"description": "Nickname 用户昵称（资料展示）。",
"type": "string"
},
"owned_tenant_count": {
"description": "OwnedTenantCount 拥有的租户数量。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间（RFC3339）。",
"type": "string"
},
"username": {
"description": "Username 用户名（用于识别/展示）。",
"type": "string"
},
"verified_at": {
"description": "VerifiedAt 实名认证时间（RFC3339）。",
"type": "string"
}
}
},
"dto.UserRolesUpdateForm": {
"type": "object",
"required": [
"roles"
],
"properties": {
"roles": {
"description": "Roles 目标角色列表（至少包含 1 个）。",
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/consts.Role"
}
}
}
},
"dto.UserStatistics": {
"type": "object",
"properties": {
"count": {
"description": "Count 该状态用户数量。",
"type": "integer"
},
"status": {
"description": "Status 用户状态枚举。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述（用于展示）。",
"type": "string"
}
}
},
"dto.UserStatusUpdateForm": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"description": "Status 目标用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
}
}
},
"dto.UserTenantItem": {
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"expired_at": {
"description": "ExpiredAt 租户过期时间（RFC3339）。",
"type": "string"
},
"joined_at": {
"description": "JoinedAt 加入时间（RFC3339）。",
"type": "string"
},
"member_status": {
"description": "MemberStatus 成员状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"member_status_description": {
"description": "MemberStatusDescription 成员状态描述。",
"type": "string"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"owner": {
"description": "Owner 租户所有者用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantOwnerUserLite"
}
]
},
"role": {
"description": "Role 用户在该租户内的角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.TenantUserRole"
}
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_status": {
"description": "TenantStatus 租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
},
"tenant_status_description": {
"description": "TenantStatusDescription 租户状态描述。",
"type": "string"
}
}
},
"dto.UserUpdate": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"bio": {
"description": "Bio 个人简介。",
"type": "string"
},
"birthday": {
"description": "Birthday 生日（YYYY-MM-DD）。",
"type": "string"
},
"gender": {
"description": "Gender 性别（枚举）。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"location": {
"description": "Location 地区信息（省/市）。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.Location"
}
]
},
"nickname": {
"description": "Nickname 昵称。",
"type": "string"
}
}
},
"dto.WalletResponse": {
"type": "object",
"properties": {
"balance": {
"description": "Balance 账户余额（单位元）。",
"type": "number"
},
"transactions": {
"description": "Transactions 交易流水列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.Transaction"
}
}
}
},
"quyun_v2_app_http_super_v1_dto.Location": {
"type": "object",
"properties": {
"city": {
"description": "City 城市名称。",
"type": "string"
},
"province": {
"description": "Province 省份名称。",
"type": "string"
}
}
},
"quyun_v2_app_http_super_v1_dto.LoginForm": {
"type": "object",
"properties": {
"password": {
"description": "Password 登录密码（加密传输）。",
"type": "string"
},
"username": {
"description": "Username 登录用户名。",
"type": "string"
}
}
},
"quyun_v2_app_http_super_v1_dto.LoginResponse": {
"type": "object",
"properties": {
"token": {
"description": "Token 登录后签发的 JWT。",
"type": "string"
},
"user": {
"description": "User 当前登录用户信息。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.User"
}
]
}
}
},
"quyun_v2_app_http_super_v1_dto.User": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"balance": {
"description": "Balance 账户余额（元）。",
"type": "number"
},
"bio": {
"description": "Bio 用户简介。",
"type": "string"
},
"birthday": {
"description": "Birthday 生日（YYYY-MM-DD）。",
"type": "string"
},
"gender": {
"description": "Gender 性别（male/female/secret）。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否已实名认证。",
"type": "boolean"
},
"location": {
"description": "Location 所在地（省/市）。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.Location"
}
]
},
"nickname": {
"description": "Nickname 用户昵称。",
"type": "string"
},
"phone": {
"description": "Phone 手机号。",
"type": "string"
},
"points": {
"description": "Points 用户积分。",
"type": "integer"
}
}
},
"quyun_v2_app_http_v1_dto.Location": {
"type": "object",
"properties": {
"city": {
"description": "City 城市名称。",
"type": "string"
},
"province": {
"description": "Province 省份名称。",
"type": "string"
}
}
},
"quyun_v2_app_http_v1_dto.LoginForm": {
"type": "object",
"properties": {
"otp": {
"description": "OTP 短信验证码。",
"type": "string"
},
"phone": {
"description": "Phone 手机号（登录账号）。",
"type": "string"
}
}
},
"quyun_v2_app_http_v1_dto.LoginResponse": {
"type": "object",
"properties": {
"token": {
"description": "Token 登录成功后的 JWT。",
"type": "string"
},
"user": {
"description": "User 当前登录用户信息。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.User"
}
]
}
}
},
"quyun_v2_app_http_v1_dto.SendOTPForm": {
"type": "object",
"properties": {
"phone": {
"description": "Phone 手机号（用于发送验证码）。",
"type": "string"
}
}
},
"quyun_v2_app_http_v1_dto.User": {
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"balance": {
"description": "Balance 余额（单位元）。",
"type": "number"
},
"bio": {
"description": "Bio 个人简介。",
"type": "string"
},
"birthday": {
"description": "Birthday 生日（YYYY-MM-DD）。",
"type": "string"
},
"gender": {
"description": "Gender 性别（枚举）。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否完成实名认证。",
"type": "boolean"
},
"location": {
"description": "Location 地区信息（省/市）。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_v1_dto.Location"
}
]
},
"nickname": {
"description": "Nickname 昵称。",
"type": "string"
},
"phone": {
"description": "Phone 绑定手机号。",
"type": "string"
},
"points": {
"description": "Points 积分余额。",
"type": "integer"
}
}
},
"requests.KV": {
"type": "object",
"properties": {
"key": {
"description": "Key is a machine-readable value, usually an enum string.",
"type": "string"
},
"value": {
"description": "Value is the label payload, often a human-readable string."
}
}
},
"requests.Pager": {
"type": "object",
"properties": {
"items": {
"description": "Items is the paged result list; concrete type depends on endpoint."
},
"limit": {
"description": "Limit is page size; only values in {10,20,50,100} are accepted (otherwise defaults to 10).",
"type": "integer"
},
"page": {
"description": "Page is 1-based page index; values \u003c= 0 are normalized to 1.",
"type": "integer"
},
"total": {
"description": "Total is the total number of items matching current filter (before paging).",
"type": "integer"
}
}
}
},
"securityDefinitions": {
"BasicAuth": {
"type": "basic"
}
},
"externalDocs": {
"description": "OpenAPI",
"url": "https://swagger.io/resources/open-api/"
}
}`
// SwaggerInfo holds exported Swagger Info so clients can modify it
var SwaggerInfo = &swag.Spec{
Version: "1.0",
Host: "localhost:8080",
BasePath: "/",
Schemes: []string{},
Title: "ApiDoc",
Description: "Multi-tenant media platform backend API.",
InfoInstanceName: "swagger",
SwaggerTemplate: docTemplate,
LeftDelim: "{{",
RightDelim: "}}",
}
func init() {
swag.Register(SwaggerInfo.InstanceName(), SwaggerInfo)
}
Reference in New Issue View Git Blame Copy Permalink