{ "swagger": "2.0", "info": { "description": "TopFans 后端 API 文档 - 微服务架构 Gateway 层", "title": "TopFans API", "contact": {}, "version": "1.0" }, "host": "localhost:8080", "basePath": "/api/v1", "paths": { "/api/v1/account/password": { "post": { "security": [ { "BearerAuth": [] } ], "description": "更新当前用户的登录密码", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "更新用户密码", "parameters": [ { "description": "更新密码请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.UpdatePasswordRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取活动列表，支持按star_id筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "获取活动列表", "parameters": [ { "type": "integer", "format": "int64", "description": "粉丝身份ID", "name": "star_id", "in": "query", "required": true }, { "type": "string", "description": "活动状态: pending/active/completed/expired", "name": "status", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认10", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities/{activity_id}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取活动详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "获取活动详情", "parameters": [ { "type": "integer", "format": "int64", "description": "活动ID", "name": "activity_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities/{activity_id}/items": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取活动道具列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "获取活动道具列表", "parameters": [ { "type": "integer", "format": "int64", "description": "活动ID", "name": "activity_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities/{activity_id}/progress": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取活动进度", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "获取活动进度", "parameters": [ { "type": "integer", "format": "int64", "description": "活动ID", "name": "activity_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities/{activity_id}/purchase": { "post": { "security": [ { "BearerAuth": [] } ], "description": "购买活动道具", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "购买道具", "parameters": [ { "type": "integer", "format": "int64", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "description": "购买请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/activity.PurchaseItemRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/activities/{activity_id}/ranking": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取活动贡献点排名", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "activities" ], "summary": "获取贡献点排名", "parameters": [ { "type": "integer", "format": "int64", "description": "活动ID", "name": "activity_id", "in": "path", "required": true }, { "type": "integer", "format": "int64", "description": "粉丝身份ID", "name": "star_id", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认10", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/me/items": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户的数字藏品列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "获取我的藏品", "parameters": [ { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20", "name": "page_size", "in": "query" }, { "type": "string", "description": "藏品状态", "name": "status", "in": "query" }, { "type": "string", "description": "搜索关键词", "name": "keyword", "in": "query" }, { "type": "string", "description": "排序方式，默认created_at_desc", "name": "sort", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/mints": { "post": { "security": [ { "BearerAuth": [] } ], "description": "创建一个新的数字藏品铸造订单", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "创建铸造订单", "parameters": [ { "description": "铸造订单请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateMintOrderRequestDTO" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/mints/precreate": { "post": { "security": [ { "BearerAuth": [] } ], "description": "上传素材后先创建 PENDING 订单，返回 order_id，前端决定是否继续铸造或取消", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "预创建铸造订单（阶段一）", "parameters": [ { "description": "预创建铸造订单请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.PreCreateMintOrderRequestDTO" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/mints/{order_id}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询指定铸造订单的状态和详细信息。订单状态包括：PROCESSING（处理中）、SUCCESS（成功）、FAILED（失败）。成功时会返回关联的资产信息，包括 cover_url_signed（预签名URL）和 tx_hash（交易哈希）。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "查询铸造订单状态", "parameters": [ { "type": "string", "description": "订单ID（UUID格式）", "name": "order_id", "in": "path", "required": true } ], "responses": { "200": { "description": "成功返回订单和资产信息", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.GetMintOrderResponseDTO" } } } ] } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/response.Response" } }, "401": { "description": "未授权", "schema": { "$ref": "#/definitions/response.Response" } }, "404": { "description": "订单不存在", "schema": { "$ref": "#/definitions/response.Response" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "取消指定铸造订单", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "取消铸造订单", "parameters": [ { "type": "string", "description": "订单ID", "name": "order_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/oss/batch-presigned-urls": { "get": { "security": [ { "BearerAuth": [] } ], "description": "批量获取OSS预签名URL用于下载多个文件", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "批量获取OSS预签名URL", "parameters": [ { "type": "string", "description": "类型: avatar/asset", "name": "type", "in": "query", "required": true }, { "type": "integer", "description": "过期时间(秒)，默认3600", "name": "expires", "in": "query" }, { "type": "integer", "description": "最大返回数量，默认100", "name": "max_keys", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/oss/presigned-url": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取OSS预签名URL用于下载文件。file_name 支持三种形式：1）纯文件名（自动拼接当前用户的路径）；2）完整 OSS key（例如 asset/7/88/materials/x.png）；3）完整 OSS URL（例如 https://bucket.oss-xx.aliyuncs.com/asset/...）。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "获取OSS预签名URL", "parameters": [ { "type": "string", "description": "类型: avatar/asset", "name": "type", "in": "query", "required": true }, { "type": "string", "description": "文件名或完整OSS key/URL", "name": "file_name", "in": "query", "required": true }, { "type": "integer", "description": "过期时间(秒)，默认3600，最大86400", "name": "expires", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/oss/signature": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取阿里云OSS上传签名和策略（阶段一：素材准备）。前端调用此接口获取上传签名后，可以直接上传图片到 OSS，获得 material_url。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "获取OSS上传签名", "parameters": [ { "type": "string", "description": "上传类型: avatar/asset，默认asset", "name": "type", "in": "query" }, { "type": "string", "description": "订单ID（可选）。不传则后端生成，并在响应中返回，用于后续铸造全流程唯一标识", "name": "order_id", "in": "query" } ], "responses": { "200": { "description": "成功返回上传签名信息", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "type": "object", "properties": { "dir": { "type": "string" }, "expire_time": { "type": "integer" }, "host": { "type": "string" }, "order_id": { "type": "string" }, "policy": { "type": "string" }, "security_token": { "type": "string" }, "signature": { "type": "string" }, "x_oss_credential": { "type": "string" }, "x_oss_date": { "type": "string" }, "x_oss_signature_version": { "type": "string" } } } } } ] } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/response.Response" } }, "401": { "description": "未授权", "schema": { "$ref": "#/definitions/response.Response" } }, "500": { "description": "OSS配置错误或生成签名失败", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/oss/upload-signature": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取阿里云OSS上传签名和策略（阶段一：素材准备）。前端调用此接口获取上传签名后，可以直接上传图片到 OSS，获得 material_url。", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "获取OSS上传签名", "parameters": [ { "type": "string", "description": "上传类型: avatar/asset，默认asset", "name": "type", "in": "query" }, { "type": "string", "description": "订单ID（可选）。不传则后端生成，并在响应中返回，用于后续铸造全流程唯一标识", "name": "order_id", "in": "query" } ], "responses": { "200": { "description": "成功返回上传签名信息", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "type": "object", "properties": { "dir": { "type": "string" }, "expire_time": { "type": "integer" }, "host": { "type": "string" }, "order_id": { "type": "string" }, "policy": { "type": "string" }, "security_token": { "type": "string" }, "signature": { "type": "string" }, "x_oss_credential": { "type": "string" }, "x_oss_date": { "type": "string" }, "x_oss_signature_version": { "type": "string" } } } } } ] } }, "400": { "description": "参数错误", "schema": { "$ref": "#/definitions/response.Response" } }, "401": { "description": "未授权", "schema": { "$ref": "#/definitions/response.Response" } }, "500": { "description": "OSS配置错误或生成签名失败", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/upload": { "post": { "security": [ { "BearerAuth": [] } ], "description": "上传图片到系统（提供图片URL）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "上传图片", "parameters": [ { "description": "图片URL和类型: cover/material", "name": "request", "in": "body", "required": true, "schema": { "type": "object", "properties": { "image_url": { "type": "string" }, "type": { "type": "string" } } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/{asset_id}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取指定资产的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "获取资产详情", "parameters": [ { "type": "integer", "description": "资产ID", "name": "asset_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/assets/{asset_id}/status": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询指定资产的上链状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "assets" ], "summary": "查询上链状态", "parameters": [ { "type": "integer", "description": "资产ID", "name": "asset_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/auth/check-nickname": { "post": { "description": "检查指定昵称是否已被他人使用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "检查昵称是否被注册", "parameters": [ { "description": "检查昵称请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.CheckNicknameRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/user.CheckNicknameResponse" } } } ] } } } } }, "/api/v1/auth/login": { "post": { "description": "用户登录接口，需要提供手机号和密码", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "用户登录", "parameters": [ { "description": "登录请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.LoginRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.LoginResponseDTO" } } } ] } } } } }, "/api/v1/auth/logout": { "post": { "security": [ { "BearerAuth": [] } ], "description": "使用户访问令牌失效", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "用户登出", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/auth/me": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前登录用户的完整信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取当前用户信息", "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.GetMeResponseDTO" } } } ] } } } } }, "/api/v1/auth/refresh": { "post": { "security": [ { "BearerAuth": [] } ], "description": "使用当前访问令牌刷新获取新的访问令牌", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "刷新访问令牌", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/auth/register": { "post": { "description": "用户注册接口，需要提供手机号、密码、选择明星身份", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "用户注册", "parameters": [ { "description": "注册请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.RegisterRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.RegisterResponseDTO" } } } ] } } } } }, "/api/v1/auth/validate": { "post": { "description": "验证访问令牌的有效性", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "auth" ], "summary": "验证访问令牌", "parameters": [ { "description": "验证请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.ValidateTokenRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/fan-identities": { "get": { "description": "获取所有可选的明星粉丝身份列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取可选粉丝身份列表", "parameters": [ { "type": "string", "description": "搜索关键词", "name": "keyword", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.FanIdentityListResponseDTO" } } } ] } } } } }, "/api/v1/fan-profiles": { "get": { "description": "根据用户ID和明星ID获取粉丝档案信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取粉丝档案", "parameters": [ { "type": "integer", "description": "用户ID", "name": "user_id", "in": "query", "required": true }, { "type": "integer", "description": "明星ID", "name": "star_id", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/galleries/me": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户的展馆信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "获取我的展馆", "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.GetMyGalleryResponseDTO" } } } ] } } } } }, "/api/v1/galleries/place": { "post": { "security": [ { "BearerAuth": [] } ], "description": "在指定展位放置数字藏品进行展示", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "放置藏品", "parameters": [ { "description": "展位ID和资产ID", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.PlaceAssetRequestDTO" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/galleries/random": { "get": { "security": [ { "BearerAuth": [] } ], "description": "随机返回一个玩家的展馆信息，格式与 GET /api/v1/galleries/:target_uid 一致", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "获取随机展馆", "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.GetUserGalleryResponseDTO" } } } ] } } } } }, "/api/v1/galleries/slots/{slot_id}/asset": { "delete": { "security": [ { "BearerAuth": [] } ], "description": "从指定展位移除展示的藏品", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "移除藏品", "parameters": [ { "type": "integer", "description": "展位ID", "name": "slot_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/galleries/slots_unlock": { "post": { "security": [ { "BearerAuth": [] } ], "description": "解锁或购买新的展位", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "解锁展位", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/galleries/{target_uid}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取指定用户的展馆信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "galleries" ], "summary": "获取他人展馆", "parameters": [ { "type": "integer", "description": "用户ID", "name": "target_uid", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.GetUserGalleryResponseDTO" } } } ] } } } } }, "/api/v1/me/avatar": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新当前用户的头像URL", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "更新用户头像", "parameters": [ { "description": "更新头像请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.UpdateAvatarRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/me/nickname": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新当前用户的粉丝昵称", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "更新用户昵称", "parameters": [ { "description": "更新昵称请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.UpdateNicknameRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.UpdateNicknameResponseDTO" } } } ] } } } } }, "/api/v1/me/profile": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前登录用户的粉丝档案信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取当前用户粉丝档案", "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.ProfileResponseDTO" } } } ] } } } } }, "/api/v1/my/fan-identities": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户拥有的所有粉丝身份列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取我的粉丝身份列表", "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.MyFanIdentitiesResponseDTO" } } } ] } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "为当前用户添加一个新的明星粉丝身份", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "添加粉丝身份", "parameters": [ { "description": "添加身份请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.AddIdentityRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.AddIdentityResponseDTO" } } } ] } } } } }, "/api/v1/my/fan-identities/switch": { "post": { "security": [ { "BearerAuth": [] } ], "description": "切换到指定的粉丝身份，返回新的访问令牌", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "切换粉丝身份", "parameters": [ { "description": "切换身份请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/user.SwitchIdentityRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "allOf": [ { "$ref": "#/definitions/response.Response" }, { "type": "object", "properties": { "data": { "$ref": "#/definitions/dto.SwitchIdentityResponseDTO" } } } ] } } } } }, "/api/v1/rankings/hot": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取热度排行榜，支持按维度筛选(displaying:展示中, month:本月, total:全部)", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "rankings" ], "summary": "获取热度排行榜", "parameters": [ { "type": "string", "description": "统计维度: displaying(展示中), month(本月), total(全部)，默认total", "name": "dimension", "in": "query" }, { "type": "integer", "format": "int64", "description": "粉丝身份ID，不传则使用当前身份", "name": "star_id", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认10", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/rankings/original": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取自制藏品排行榜，支持按维度筛选(displaying:展示中, month:本月, total:全部)", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "rankings" ], "summary": "获取自制排行榜", "parameters": [ { "type": "string", "description": "统计维度: displaying(展示中), month(本月), total(全部)，默认total", "name": "dimension", "in": "query" }, { "type": "integer", "format": "int64", "description": "粉丝身份ID，不传则使用当前身份", "name": "star_id", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认10", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/assets/{asset_id}/like": { "post": { "security": [ { "BearerAuth": [] } ], "description": "对指定资产进行点赞", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "点赞资产", "parameters": [ { "type": "integer", "description": "资产ID", "name": "asset_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "取消对指定资产的点赞", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "取消点赞", "parameters": [ { "type": "integer", "description": "资产ID", "name": "asset_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friend-requests": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户的好友请求列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "获取好友请求列表", "parameters": [ { "type": "string", "description": "请求类型: received/sent", "name": "type", "in": "query" }, { "type": "string", "description": "请求状态", "name": "status", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "向指定用户发送好友请求", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "发送好友请求", "parameters": [ { "description": "好友请求参数", "name": "request", "in": "body", "required": true, "schema": { "type": "object", "properties": { "friend_user_id": { "type": "integer" }, "message": { "type": "string" } } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friend-requests/handle": { "post": { "security": [ { "BearerAuth": [] } ], "description": "接受或拒绝好友请求", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "处理好友请求", "parameters": [ { "description": "处理请求参数: action=accept/reject", "name": "request", "in": "body", "required": true, "schema": { "type": "object", "properties": { "action": { "type": "string" }, "request_id": { "type": "integer" } } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friends": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户的好友列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "获取好友列表", "parameters": [ { "type": "string", "description": "搜索关键词", "name": "keyword", "in": "query" }, { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定好友", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "删除好友", "parameters": [ { "description": "好友用户ID", "name": "request", "in": "body", "required": true, "schema": { "type": "object", "properties": { "friend_user_id": { "type": "integer" } } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friends/count": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取当前用户的好友数量", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "获取好友数量", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friends/remark": { "put": { "security": [ { "BearerAuth": [] } ], "description": "设置指定好友的备注名称", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "设置好友备注", "parameters": [ { "description": "好友ID和备注", "name": "request", "in": "body", "required": true, "schema": { "type": "object", "properties": { "friend_user_id": { "type": "integer" }, "remark": { "type": "string" } } } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/friendship/check": { "get": { "security": [ { "BearerAuth": [] } ], "description": "检查当前用户与指定用户是否为好友关系", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "检查好友关系", "parameters": [ { "type": "integer", "description": "好友用户ID", "name": "friend_user_id", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/random-users": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取同一明星身份下的随机推荐用户", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "获取随机用户", "parameters": [ { "type": "integer", "description": "获取数量，默认1，最大100", "name": "count", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/search-user": { "get": { "security": [ { "BearerAuth": [] } ], "description": "根据用户ID查找用户信息，用于添加好友", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "查找用户", "parameters": [ { "type": "integer", "description": "粉丝档案ID", "name": "friend_fan_profile_id", "in": "query", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/social/users": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取同一明星身份下的分页用户列表，包含用户ID、展馆所有者ID、昵称、等级", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social" ], "summary": "获取分页用户列表", "parameters": [ { "type": "integer", "description": "页码，默认1", "name": "page", "in": "query" }, { "type": "integer", "description": "每页数量，默认20，最大100", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } }, "/api/v1/users/{user_id}": { "get": { "description": "根据用户ID获取用户公开信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "users" ], "summary": "获取指定用户信息", "parameters": [ { "type": "integer", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/response.Response" } } } } } }, "definitions": { "activity.PurchaseItemRequest": { "type": "object", "properties": { "activity_id": { "type": "integer" }, "item_type": { "type": "string" }, "quantity": { "type": "integer" }, "star_id": { "type": "integer" }, "user_id": { "description": "当前用户ID", "type": "integer" } } }, "common.BaseResponse": { "type": "object", "properties": { "code": { "description": "状态码", "allOf": [ { "$ref": "#/definitions/common.StatusCode" } ] }, "message": { "description": "错误信息（成功时为空）", "type": "string" }, "timestamp": { "description": "响应时间戳（Unix时间戳毫秒）", "type": "integer" } } }, "common.StatusCode": { "type": "integer", "format": "int32", "enum": [ 0, 200, 400, 401, 403, 404, 429, 500 ], "x-enum-varnames": [ "StatusCode_STATUS_UNSPECIFIED", "StatusCode_STATUS_OK", "StatusCode_STATUS_BAD_REQUEST", "StatusCode_STATUS_UNAUTHORIZED", "StatusCode_STATUS_FORBIDDEN", "StatusCode_STATUS_NOT_FOUND", "StatusCode_STATUS_TOO_MANY_REQUESTS", "StatusCode_STATUS_INTERNAL_ERROR" ] }, "dto.AddIdentityResponseDTO": { "type": "object", "properties": { "bound": { "type": "boolean" }, "identity_id": { "type": "string" } } }, "dto.AssetDTO": { "type": "object", "properties": { "asset_id": { "description": "资产ID", "type": "integer" }, "block_number": { "description": "区块号（可选）", "type": "integer" }, "cover_url": { "description": "封面图URL", "type": "string" }, "cover_url_signed": { "description": "封面图预签名URL（自动生成）", "type": "string" }, "created_at": { "description": "创建时间（毫秒时间戳）", "type": "integer" }, "description": { "description": "藏品描述（可选）", "type": "string" }, "is_liked": { "description": "当前用户是否已点赞", "type": "boolean" }, "like_count": { "description": "点赞数", "type": "integer" }, "material_url": { "description": "用户上传的素材URL", "type": "string" }, "material_url_signed": { "description": "素材图预签名URL（自动生成）", "type": "string" }, "minted_at": { "description": "上链成功时间（毫秒时间戳，可选）", "type": "integer" }, "name": { "description": "藏品名称", "type": "string" }, "owner": { "description": "持有者信息（可选，保留用于兼容性）", "allOf": [ { "$ref": "#/definitions/dto.OwnerInfoDTO" } ] }, "owner_nickname": { "description": "持有者昵称（在该star下的昵称）", "type": "string" }, "owner_uid": { "description": "当前持有者", "type": "integer" }, "rarity": { "description": "稀有度（可选）", "type": "integer" }, "star_id": { "description": "所属星球", "type": "integer" }, "status": { "description": "状态：0=Pending, 1=Active", "type": "integer" }, "tags": { "description": "标签数组（可选）", "type": "array", "items": { "type": "string" } }, "tx_hash": { "description": "交易哈希（可选）", "type": "string" }, "updated_at": { "description": "更新时间（毫秒时间戳）", "type": "integer" }, "visibility": { "description": "可见性：private, friends, public", "type": "string" } } }, "dto.AssetInfoDTO": { "type": "object", "properties": { "asset_id": { "description": "资产ID", "type": "integer" }, "cover_url": { "description": "封面图URL", "type": "string" }, "like_count": { "description": "点赞数", "type": "integer" }, "name": { "description": "资产名称", "type": "string" }, "remain_time": { "description": "剩余时间（秒）", "type": "integer" } } }, "dto.CreateMintOrderRequestDTO": { "type": "object", "required": [ "material_url", "name", "order_id" ], "properties": { "description": { "description": "藏品描述（可选）", "type": "string" }, "event": { "description": "藏品事件（可选）", "type": "string" }, "material_type": { "description": "素材类型（可选）", "type": "string" }, "material_url": { "description": "用户上传的素材URL（必填，前端已上传到OSS）", "type": "string" }, "name": { "description": "藏品名称（必填）", "type": "string" }, "order_id": { "description": "阶段一生成的订单ID（必填）", "type": "string" }, "rarity": { "description": "稀有度（可选）", "type": "integer" }, "tags": { "description": "标签列表（可选）", "type": "array", "items": { "type": "string" } } } }, "dto.CurrentIdentityDTO": { "type": "object", "properties": { "crystal_balance": { "type": "integer" }, "identity_id": { "description": "\"wyb\"", "type": "string" }, "identity_name": { "description": "\"王一博\"", "type": "string" }, "level": { "type": "integer" }, "star_id": { "description": "明星ID", "type": "integer" }, "tag": { "description": "\"小摩托\"", "type": "string" } } }, "dto.FanIdentityDTO": { "type": "object", "properties": { "identity_id": { "description": "stars.identity_id（如\"wyb\"）", "type": "string" }, "name": { "description": "stars.name（原始名称，如\"王一博\"）", "type": "string" }, "star_id": { "description": "明星ID", "type": "integer" }, "tag": { "description": "stars.tag（昵称标签，如\"小摩托\"）", "type": "string" } } }, "dto.FanIdentityListItemDTO": { "type": "object", "properties": { "identity_id": { "description": "\"wyb\"", "type": "string" }, "name": { "description": "\"王一博\"", "type": "string" }, "pic_url": { "type": "string" }, "star_id": { "description": "88（star 的主键 ID，用于切换身份）", "type": "integer" }, "tag": { "description": "\"小摩托\"", "type": "string" } } }, "dto.FanIdentityListResponseDTO": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/dto.FanIdentityListItemDTO" } }, "total": { "type": "integer" } } }, "dto.GetMeResponseDTO": { "type": "object", "properties": { "avatar_url": { "type": "string" }, "chain_address": { "type": "string" }, "current_identity": { "$ref": "#/definitions/dto.CurrentIdentityDTO" }, "nickname": { "type": "string" }, "uid": { "type": "integer" } } }, "dto.GetMintOrderResponseDTO": { "type": "object", "properties": { "asset": { "description": "关联的资产信息（如果存在）", "allOf": [ { "$ref": "#/definitions/dto.AssetDTO" } ] }, "order": { "description": "订单信息", "allOf": [ { "$ref": "#/definitions/dto.MintOrderDTO" } ] } } }, "dto.GetMyGalleryResponseDTO": { "type": "object", "properties": { "gallery_owner_id": { "description": "展馆所有者ID", "type": "integer" }, "nickname": { "description": "展馆所有者昵称", "type": "string" }, "slot_total": { "description": "展位总数", "type": "integer" }, "slots": { "description": "展位列表", "type": "array", "items": { "$ref": "#/definitions/dto.SlotInfoDTO" } } } }, "dto.GetUserGalleryResponseDTO": { "type": "object", "properties": { "gallery_owner_id": { "description": "展馆所有者ID", "type": "integer" }, "nickname": { "description": "展馆所有者昵称", "type": "string" }, "slot_total": { "description": "展位总数", "type": "integer" }, "slots": { "description": "展位列表", "type": "array", "items": { "$ref": "#/definitions/dto.SlotInfoDTO" } } } }, "dto.LoginResponseDTO": { "type": "object", "properties": { "access_token": { "type": "string" }, "expires_in": { "type": "integer" }, "refresh_token": { "type": "string" }, "user": { "$ref": "#/definitions/dto.UserWithIdentityDTO" } } }, "dto.MintOrderDTO": { "type": "object", "properties": { "asset_id": { "description": "关联资产ID", "type": "integer" }, "cost_crystal": { "description": "消耗的水晶数量", "type": "integer" }, "cover_url": { "description": "订单查询响应中的扩展字段", "type": "string" }, "cover_url_signed": { "description": "封面图预签名URL（成功时）", "type": "string" }, "created_at": { "description": "创建时间（毫秒时间戳）", "type": "integer" }, "description": { "description": "阶段一保存的描述（可选）", "type": "string" }, "error_message": { "description": "错误信息（可选）", "type": "string" }, "event": { "description": "藏品事件（可选）", "type": "string" }, "material_type": { "description": "素材类型（可选）", "type": "string" }, "material_url": { "description": "阶段一保存的素材URL（可选）", "type": "string" }, "minted_at": { "description": "上链成功时间（毫秒时间戳，可选）", "type": "integer" }, "name": { "description": "阶段一保存的名称（可选）", "type": "string" }, "order_id": { "description": "订单ID（UUID）", "type": "string" }, "retry_count": { "description": "重试次数", "type": "integer" }, "star_id": { "description": "明星ID", "type": "integer" }, "status": { "description": "状态：PENDING, PROCESSING, SUCCESS, FAILED", "type": "string" }, "tx_hash": { "description": "交易哈希（成功时）", "type": "string" }, "updated_at": { "description": "更新时间（毫秒时间戳）", "type": "integer" }, "user_id": { "description": "用户ID", "type": "integer" } } }, "dto.MyFanIdentitiesResponseDTO": { "type": "object", "properties": { "current_star_id": { "description": "当前激活的明星ID", "type": "integer" }, "items": { "type": "array", "items": { "$ref": "#/definitions/dto.MyFanIdentityItemDTO" } }, "total": { "type": "integer" } } }, "dto.MyFanIdentityItemDTO": { "type": "object", "properties": { "crystal_balance": { "description": "水晶余额", "type": "integer" }, "experience": { "description": "经验值", "type": "integer" }, "identity_id": { "description": "身份ID（如 \"xz\"）", "type": "string" }, "is_active": { "description": "是否激活（当前使用）", "type": "boolean" }, "level": { "description": "等级", "type": "integer" }, "nickname": { "description": "用户昵称", "type": "string" }, "star_id": { "description": "明星ID", "type": "integer" }, "star_name": { "description": "明星名称", "type": "string" }, "star_tag": { "description": "明星标签", "type": "string" } } }, "dto.OwnerInfoDTO": { "type": "object", "properties": { "avatar": { "description": "头像URL", "type": "string" }, "nickname": { "description": "昵称", "type": "string" }, "user_id": { "description": "用户ID", "type": "integer" } } }, "dto.PlaceAssetRequestDTO": { "type": "object", "required": [ "asset_id", "gallery_owner_id", "slot_id" ], "properties": { "asset_id": { "description": "资产ID（必填）", "type": "integer" }, "gallery_owner_id": { "description": "展馆所有者ID（必填）", "type": "integer" }, "slot_id": { "description": "展位ID（必填）", "type": "integer" } } }, "dto.PreCreateMintOrderRequestDTO": { "type": "object", "required": [ "material_url" ], "properties": { "description": { "description": "描述（可选）", "type": "string" }, "event": { "description": "藏品事件（可选）", "type": "string" }, "material_type": { "description": "素材类型（可选）", "type": "string" }, "material_url": { "description": "素材URL（必填）", "type": "string" }, "name": { "description": "藏品名称（可选）", "type": "string" } } }, "dto.ProfileResponseDTO": { "type": "object", "properties": { "assets_num": { "type": "integer" }, "chain_address": { "type": "string" }, "crystal_balance": { "type": "integer" }, "fan_identity": { "$ref": "#/definitions/dto.FanIdentityDTO" }, "fan_level": { "type": "integer" }, "nickname": { "type": "string" }, "slot_limit": { "type": "integer" }, "starbook_limit": { "type": "integer" }, "uid": { "type": "integer" } } }, "dto.RegisterResponseDTO": { "type": "object", "properties": { "access_token": { "type": "string" }, "expires_in": { "type": "integer" }, "user": { "$ref": "#/definitions/dto.UserWithIdentityDTO" } } }, "dto.SlotInfoDTO": { "type": "object", "properties": { "asset": { "description": "展品信息（仅当status为OCCUPIED时存在）", "allOf": [ { "$ref": "#/definitions/dto.AssetInfoDTO" } ] }, "can_operate": { "description": "当前用户是否可以操作此展位", "type": "boolean" }, "expire_at": { "description": "占用过期时间（毫秒时间戳，仅当status为OCCUPIED时存在）", "type": "integer" }, "is_enabled": { "description": "是否已解锁", "type": "boolean" }, "occupied_at": { "description": "占用开始时间（毫秒时间戳，仅当status为OCCUPIED时存在）", "type": "integer" }, "occupier_uid": { "description": "占位者用户ID（仅当status为OCCUPIED时存在）", "type": "integer" }, "operation": { "description": "操作类型: \"place\" | \"remove\" | \"none\"", "type": "string" }, "slot_id": { "description": "展位ID", "type": "integer" }, "slot_index": { "description": "展位序号", "type": "integer" }, "status": { "description": "状态：EMPTY, OCCUPIED, LOCKED", "type": "string" }, "unlock_condition": { "description": "解锁条件（仅当status为LOCKED时存在）", "allOf": [ { "$ref": "#/definitions/dto.UnlockConditionDTO" } ] }, "visibility": { "description": "public / private", "type": "string" } } }, "dto.SwitchIdentityResponseDTO": { "type": "object", "properties": { "access_token": { "type": "string" }, "current_identity": { "$ref": "#/definitions/dto.CurrentIdentityDTO" }, "expires_in": { "type": "integer" } } }, "dto.UnlockConditionDTO": { "type": "object", "properties": { "type": { "description": "解锁类型：level（等级）, crystal（水晶）", "type": "string" }, "value": { "description": "解锁条件值（等级或水晶数量）", "type": "integer" } } }, "dto.UpdateNicknameResponseDTO": { "type": "object", "properties": { "nickname": { "type": "string" } } }, "dto.UserWithIdentityDTO": { "type": "object", "properties": { "assets_num": { "description": "assets_count", "type": "integer" }, "avatar_url": { "type": "string" }, "chain_address": { "type": "string" }, "crystal_balance": { "type": "integer" }, "fan_identity": { "$ref": "#/definitions/dto.FanIdentityDTO" }, "fan_level": { "type": "integer" }, "nickname": { "type": "string" }, "slot_limit": { "type": "integer" }, "starbook_limit": { "type": "integer" }, "uid": { "description": "使用 uid，值为数据库ID", "type": "integer" } } }, "response.Response": { "type": "object", "properties": { "code": { "type": "integer" }, "data": {}, "message": { "type": "string" } } }, "user.AddIdentityRequest": { "type": "object", "properties": { "nickname": { "description": "粉丝身份昵称", "type": "string" }, "star_id": { "description": "选择的明星ID", "type": "integer" } } }, "user.CheckNicknameRequest": { "type": "object", "properties": { "nickname": { "description": "要检查的昵称", "type": "string" } } }, "user.CheckNicknameResponse": { "type": "object", "properties": { "base": { "$ref": "#/definitions/common.BaseResponse" }, "exists": { "description": "昵称是否已存在", "type": "boolean" } } }, "user.LoginRequest": { "type": "object", "properties": { "mobile": { "description": "手机号", "type": "string" }, "password": { "description": "密码", "type": "string" }, "star_id": { "description": "可选：指定登录的明星ID，不指定则使用最早创建的粉丝档案", "type": "integer" } } }, "user.RegisterRequest": { "type": "object", "properties": { "mobile": { "description": "手机号", "type": "string" }, "nickname": { "description": "第一个粉丝身份的昵称", "type": "string" }, "password": { "description": "密码", "type": "string" }, "star_id": { "description": "选择第一个粉丝身份的明星ID", "type": "integer" } } }, "user.SwitchIdentityRequest": { "type": "object", "properties": { "new_star_id": { "description": "切换到的新明星ID", "type": "integer" } } }, "user.UpdateAvatarRequest": { "type": "object", "properties": { "avatar_url": { "description": "头像URL（必填）", "type": "string" } } }, "user.UpdateNicknameRequest": { "type": "object", "properties": { "nickname": { "description": "新昵称", "type": "string" } } }, "user.UpdatePasswordRequest": { "type": "object", "properties": { "new_password": { "description": "新密码", "type": "string" }, "old_password": { "description": "旧密码", "type": "string" } } }, "user.ValidateTokenRequest": { "type": "object", "properties": { "access_token": { "type": "string" } } } }, "securityDefinitions": { "BearerAuth": { "type": "apiKey", "name": "Authorization", "in": "header" } } }