From 675e7a67834497a1c17a3264756e47f5b4ffad1f Mon Sep 17 00:00:00 2001 From: Rogee Date: Thu, 8 Jan 2026 15:13:15 +0800 Subject: [PATCH] chore: document v1 dto fields --- backend/app/http/v1/dto/auth.go | 46 ++++-- backend/app/http/v1/dto/common.go | 16 ++- backend/app/http/v1/dto/content.go | 1 + backend/app/http/v1/dto/coupon.go | 30 ++-- backend/app/http/v1/dto/creator.go | 221 ++++++++++++++++++++--------- backend/app/http/v1/dto/order.go | 20 ++- backend/app/http/v1/dto/tenant.go | 37 +++-- backend/app/http/v1/dto/upload.go | 27 ++-- backend/app/http/v1/dto/user.go | 114 ++++++++++----- 9 files changed, 355 insertions(+), 157 deletions(-) diff --git a/backend/app/http/v1/dto/auth.go b/backend/app/http/v1/dto/auth.go index 96c3390..a4309fe 100644 --- a/backend/app/http/v1/dto/auth.go +++ b/backend/app/http/v1/dto/auth.go @@ -3,34 +3,52 @@ package dto import "quyun/v2/pkg/consts" type SendOTPForm struct { + // Phone 手机号（用于发送验证码）。 Phone string `json:"phone"` } type LoginForm struct { + // Phone 手机号（登录账号）。 Phone string `json:"phone"` - OTP string `json:"otp"` + // OTP 短信验证码。 + OTP string `json:"otp"` } type LoginResponse struct { + // Token 登录成功后的 JWT。 Token string `json:"token"` - User *User `json:"user"` + // User 当前登录用户信息。 + User *User `json:"user"` } type User struct { - ID int64 `json:"id"` - Phone string `json:"phone"` - Nickname string `json:"nickname"` - Avatar string `json:"avatar"` - Gender consts.Gender `json:"gender"` - Bio string `json:"bio"` - Birthday string `json:"birthday"` // YYYY-MM-DD - Location *Location `json:"location"` - Balance float64 `json:"balance"` - Points int64 `json:"points"` - IsRealNameVerified bool `json:"is_real_name_verified"` + // ID 用户ID。 + ID int64 `json:"id"` + // Phone 绑定手机号。 + Phone string `json:"phone"` + // Nickname 昵称。 + Nickname string `json:"nickname"` + // Avatar 头像URL。 + Avatar string `json:"avatar"` + // Gender 性别（枚举）。 + Gender consts.Gender `json:"gender"` + // Bio 个人简介。 + Bio string `json:"bio"` + // Birthday 生日（YYYY-MM-DD）。 + Birthday string `json:"birthday"` + // Location 地区信息（省/市）。 + Location *Location `json:"location"` + // Balance 余额（单位元）。 + Balance float64 `json:"balance"` + // Points 积分余额。 + Points int64 `json:"points"` + // IsRealNameVerified 是否完成实名认证。 + IsRealNameVerified bool `json:"is_real_name_verified"` } type Location struct { + // Province 省份名称。 Province string `json:"province"` - City string `json:"city"` + // City 城市名称。 + City string `json:"city"` } diff --git a/backend/app/http/v1/dto/common.go b/backend/app/http/v1/dto/common.go index 46d31ce..3a1a551 100644 --- a/backend/app/http/v1/dto/common.go +++ b/backend/app/http/v1/dto/common.go @@ -3,18 +3,26 @@ package dto import "quyun/v2/app/requests" type UploadResult struct { - ID int64 `json:"id"` - URL string `json:"url"` + // ID 媒体资源ID。 + ID int64 `json:"id"` + // URL 访问地址（包含签名或公共URL）。 + URL string `json:"url"` + // Filename 原始文件名。 Filename string `json:"filename"` - Size int64 `json:"size"` + // Size 文件大小（字节）。 + Size int64 `json:"size"` + // MimeType 文件类型（如 image/png）。 MimeType string `json:"mime_type"` } type OptionsResponse struct { + // ContentStatus 内容状态选项。 ContentStatus []requests.KV `json:"content_status"` - ContentGenre []requests.KV `json:"content_genre"` + // ContentGenre 内容类型/分类选项。 + ContentGenre []requests.KV `json:"content_genre"` } type UploadForm struct { + // Type 上传资源类型（如 cover/media/avatar）。 Type string `form:"type" json:"type"` } diff --git a/backend/app/http/v1/dto/content.go b/backend/app/http/v1/dto/content.go index 7e41d76..e5941a6 100644 --- a/backend/app/http/v1/dto/content.go +++ b/backend/app/http/v1/dto/content.go @@ -3,6 +3,7 @@ package dto import "quyun/v2/app/requests" type ContentListFilter struct { + // Pagination 分页参数（page/limit）。 requests.Pagination // Keyword 关键词搜索（匹配标题/摘要/描述）。 Keyword *string `query:"keyword"` diff --git a/backend/app/http/v1/dto/coupon.go b/backend/app/http/v1/dto/coupon.go index cc6f289..94701a2 100644 --- a/backend/app/http/v1/dto/coupon.go +++ b/backend/app/http/v1/dto/coupon.go @@ -1,14 +1,24 @@ package dto type UserCouponItem struct { - ID int64 `json:"id"` - CouponID int64 `json:"coupon_id"` - Title string `json:"title"` - Description string `json:"description"` - Type string `json:"type"` - Value int64 `json:"value"` - MinOrderAmount int64 `json:"min_order_amount"` - StartAt string `json:"start_at"` - EndAt string `json:"end_at"` - Status string `json:"status"` + // ID 用户券ID。 + ID int64 `json:"id"` + // CouponID 券模板ID。 + CouponID int64 `json:"coupon_id"` + // Title 券标题。 + Title string `json:"title"` + // Description 券描述。 + Description string `json:"description"` + // Type 券类型（满减/折扣）。 + Type string `json:"type"` + // Value 券面值（分/百分比）。 + Value int64 `json:"value"` + // MinOrderAmount 使用门槛金额（分）。 + MinOrderAmount int64 `json:"min_order_amount"` + // StartAt 生效时间（RFC3339）。 + StartAt string `json:"start_at"` + // EndAt 过期时间（RFC3339）。 + EndAt string `json:"end_at"` + // Status 当前状态（可用/已用/过期）。 + Status string `json:"status"` } diff --git a/backend/app/http/v1/dto/creator.go b/backend/app/http/v1/dto/creator.go index c8a4227..9f2fdd6 100644 --- a/backend/app/http/v1/dto/creator.go +++ b/backend/app/http/v1/dto/creator.go @@ -3,131 +3,216 @@ package dto import "quyun/v2/app/requests" type ApplyForm struct { - Name string `json:"name"` - Bio string `json:"bio"` + // Name 频道/创作者名称。 + Name string `json:"name"` + // Bio 频道简介。 + Bio string `json:"bio"` + // Avatar 头像URL。 Avatar string `json:"avatar"` } type DashboardStats struct { - TotalFollowers IntStatItem `json:"total_followers"` - TotalRevenue FloatStatItem `json:"total_revenue"` - PendingRefunds int `json:"pending_refunds"` - NewMessages int `json:"new_messages"` + // TotalFollowers 粉丝总数统计。 + TotalFollowers IntStatItem `json:"total_followers"` + // TotalRevenue 累计收入统计（单位元）。 + TotalRevenue FloatStatItem `json:"total_revenue"` + // PendingRefunds 待处理退款数量。 + PendingRefunds int `json:"pending_refunds"` + // NewMessages 新消息数量。 + NewMessages int `json:"new_messages"` } type IntStatItem struct { - Value int `json:"value"` + // Value 统计数值。 + Value int `json:"value"` + // Trend 环比/同比变化比例。 Trend float64 `json:"trend"` } type FloatStatItem struct { + // Value 统计数值（浮点）。 Value float64 `json:"value"` + // Trend 环比/同比变化比例。 Trend float64 `json:"trend"` } type ContentCreateForm struct { - Title string `json:"title"` - Genre string `json:"genre"` - Key string `json:"key"` - Price float64 `json:"price"` - Status string `json:"status"` + // Title 内容标题。 + Title string `json:"title"` + // Genre 内容分类/风格。 + Genre string `json:"genre"` + // Key 音乐调性或主音。 + Key string `json:"key"` + // Price 价格（单位元）。 + Price float64 `json:"price"` + // Status 内容状态（draft/published）。 + Status string `json:"status"` + // CoverIDs 封面资源ID集合。 CoverIDs []int64 `json:"cover_ids"` + // MediaIDs 媒体资源ID集合（音频/视频/图片）。 MediaIDs []int64 `json:"media_ids"` } type ContentUpdateForm struct { - Title string `json:"title"` - Genre string `json:"genre"` - Key string `json:"key"` - Price *float64 `json:"price"` - Status string `json:"status"` - IsPinned *bool `json:"is_pinned"` - CoverIDs []int64 `json:"cover_ids"` - MediaIDs []int64 `json:"media_ids"` + // Title 内容标题（为空表示不修改）。 + Title string `json:"title"` + // Genre 内容分类/风格。 + Genre string `json:"genre"` + // Key 音乐调性或主音。 + Key string `json:"key"` + // Price 价格（单位元，nil 表示不修改）。 + Price *float64 `json:"price"` + // Status 内容状态（draft/published）。 + Status string `json:"status"` + // IsPinned 是否置顶。 + IsPinned *bool `json:"is_pinned"` + // CoverIDs 封面资源ID集合。 + CoverIDs []int64 `json:"cover_ids"` + // MediaIDs 媒体资源ID集合。 + MediaIDs []int64 `json:"media_ids"` } type ContentEditDTO struct { - ID int64 `json:"id"` - Title string `json:"title"` - Genre string `json:"genre"` - Key string `json:"key"` - Description string `json:"description"` - Status string `json:"status"` - Price float64 `json:"price"` - EnableTrial bool `json:"enable_trial"` - PreviewSeconds int `json:"preview_seconds"` - Assets []AssetDTO `json:"assets"` + // ID 内容ID。 + ID int64 `json:"id"` + // Title 内容标题。 + Title string `json:"title"` + // Genre 内容分类。 + Genre string `json:"genre"` + // Key 音乐调性或主音。 + Key string `json:"key"` + // Description 内容简介。 + Description string `json:"description"` + // Status 内容状态。 + Status string `json:"status"` + // Price 价格（单位元）。 + Price float64 `json:"price"` + // EnableTrial 是否开启试读/试听。 + EnableTrial bool `json:"enable_trial"` + // PreviewSeconds 试看/试听秒数。 + PreviewSeconds int `json:"preview_seconds"` + // Assets 资源列表（封面/媒体）。 + Assets []AssetDTO `json:"assets"` } type CreatorContentItem struct { - ID int64 `json:"id"` - Title string `json:"title"` - Genre string `json:"genre"` - Key string `json:"key"` - Price float64 `json:"price"` - Views int `json:"views"` - Likes int `json:"likes"` - Cover string `json:"cover"` - ImageCount int `json:"image_count"` - VideoCount int `json:"video_count"` - AudioCount int `json:"audio_count"` - Status string `json:"status"` - Visibility string `json:"visibility"` - CreatedAt string `json:"created_at"` - IsPinned bool `json:"is_pinned"` - IsPurchased bool `json:"is_purchased"` + // ID 内容ID。 + ID int64 `json:"id"` + // Title 内容标题。 + Title string `json:"title"` + // Genre 内容分类。 + Genre string `json:"genre"` + // Key 音乐调性或主音。 + Key string `json:"key"` + // Price 价格（单位元）。 + Price float64 `json:"price"` + // Views 浏览量。 + Views int `json:"views"` + // Likes 点赞数。 + Likes int `json:"likes"` + // Cover 封面URL。 + Cover string `json:"cover"` + // ImageCount 图片素材数量。 + ImageCount int `json:"image_count"` + // VideoCount 视频素材数量。 + VideoCount int `json:"video_count"` + // AudioCount 音频素材数量。 + AudioCount int `json:"audio_count"` + // Status 内容状态。 + Status string `json:"status"` + // Visibility 可见性。 + Visibility string `json:"visibility"` + // CreatedAt 创建时间（RFC3339）。 + CreatedAt string `json:"created_at"` + // IsPinned 是否置顶。 + IsPinned bool `json:"is_pinned"` + // IsPurchased 是否已购买。 + IsPurchased bool `json:"is_purchased"` } type AssetDTO struct { - ID int64 `json:"id"` + // ID 资源ID。 + ID int64 `json:"id"` + // Role 资源角色（cover/media/preview）。 Role string `json:"role"` + // Type 资源类型（image/audio/video）。 Type string `json:"type"` - URL string `json:"url"` + // URL 资源访问地址。 + URL string `json:"url"` + // Name 文件名。 Name string `json:"name"` + // Size 文件大小描述。 Size string `json:"size"` - Sort int `json:"sort"` + // Sort 排序权重。 + Sort int `json:"sort"` } type CreatorContentListFilter struct { + // Pagination 分页参数（page/limit）。 requests.Pagination - Status *string `query:"status"` + // Status 内容状态过滤。 + Status *string `query:"status"` + // Visibility 可见性过滤。 Visibility *string `query:"visibility"` - Genre *string `query:"genre"` - Key *string `query:"key"` - Keyword *string `query:"keyword"` - Sort *string `query:"sort"` + // Genre 分类筛选。 + Genre *string `query:"genre"` + // Key 调性筛选。 + Key *string `query:"key"` + // Keyword 关键词搜索（标题/简介）。 + Keyword *string `query:"keyword"` + // Sort 排序规则。 + Sort *string `query:"sort"` } type CreatorOrderListFilter struct { + // Pagination 分页参数（page/limit）。 requests.Pagination - Status *string `query:"status"` + // Status 订单状态过滤。 + Status *string `query:"status"` + // Keyword 关键词搜索（订单号/内容标题）。 Keyword *string `query:"keyword"` } type RefundForm struct { - Action string `json:"action"` // accept, reject + // Action 处理动作（accept/reject）。 + Action string `json:"action"` + // Reason 退款原因/备注。 Reason string `json:"reason"` } type Settings struct { - ID int64 `json:"id"` - Name string `json:"name"` - Bio string `json:"bio"` - Avatar string `json:"avatar"` - Cover string `json:"cover"` + // ID 租户/频道ID。 + ID int64 `json:"id"` + // Name 频道名称。 + Name string `json:"name"` + // Bio 频道简介。 + Bio string `json:"bio"` + // Avatar 头像URL。 + Avatar string `json:"avatar"` + // Cover 封面图URL。 + Cover string `json:"cover"` + // Description 详细描述。 Description string `json:"description"` } type PayoutAccount struct { - ID int64 `json:"id"` - Type string `json:"type"` // bank, alipay - Name string `json:"name"` - Account string `json:"account"` + // ID 收款账户ID。 + ID int64 `json:"id"` + // Type 账户类型（bank/alipay）。 + Type string `json:"type"` + // Name 账户名称/开户行。 + Name string `json:"name"` + // Account 收款账号。 + Account string `json:"account"` + // Realname 收款人姓名。 Realname string `json:"realname"` } type WithdrawForm struct { - Amount float64 `json:"amount"` - Method string `json:"method"` // wallet, external - AccountID int64 `json:"account_id"` + // Amount 提现金额（单位元）。 + Amount float64 `json:"amount"` + // Method 提现方式（wallet/external）。 + Method string `json:"method"` + // AccountID 收款账户ID。 + AccountID int64 `json:"account_id"` } diff --git a/backend/app/http/v1/dto/order.go b/backend/app/http/v1/dto/order.go index 5356869..c4990e9 100644 --- a/backend/app/http/v1/dto/order.go +++ b/backend/app/http/v1/dto/order.go @@ -1,24 +1,32 @@ package dto type OrderCreateForm struct { - ContentID int64 `json:"content_id"` - Sku string `json:"sku"` - Quantity int `json:"quantity"` - UserCouponID int64 `json:"user_coupon_id"` + // ContentID 内容ID。 + ContentID int64 `json:"content_id"` + // Sku 规格标识（可选）。 + Sku string `json:"sku"` + // Quantity 购买数量（默认 1）。 + Quantity int `json:"quantity"` + // UserCouponID 用户券ID（可选）。 + UserCouponID int64 `json:"user_coupon_id"` } type OrderCreateResponse struct { + // OrderID 创建成功的订单ID。 OrderID int64 `json:"order_id"` } type OrderPayForm struct { - Method string `json:"method"` // wechat, alipay, balance + // Method 支付方式（wechat/alipay/balance）。 + Method string `json:"method"` } type OrderPayResponse struct { + // PayParams 支付参数（透传给前端）。 PayParams string `json:"pay_params"` } type OrderStatusResponse struct { - Status string `json:"status"` // unpaid, paid, completed + // Status 订单状态（unpaid/paid/completed 等）。 + Status string `json:"status"` } diff --git a/backend/app/http/v1/dto/tenant.go b/backend/app/http/v1/dto/tenant.go index c8c2b72..577b44b 100644 --- a/backend/app/http/v1/dto/tenant.go +++ b/backend/app/http/v1/dto/tenant.go @@ -3,25 +3,40 @@ package dto import "quyun/v2/app/requests" type TenantListFilter struct { + // Pagination 分页参数（page/limit）。 requests.Pagination + // Keyword 关键词搜索（租户名称）。 Keyword *string `query:"keyword"` - Sort *string `query:"sort"` + // Sort 排序规则。 + Sort *string `query:"sort"` } type TenantProfile struct { - ID int64 `json:"id"` - Name string `json:"name"` - Avatar string `json:"avatar"` - Cover string `json:"cover"` - Bio string `json:"bio"` + // ID 租户ID。 + ID int64 `json:"id"` + // Name 租户名称。 + Name string `json:"name"` + // Avatar 头像URL。 + Avatar string `json:"avatar"` + // Cover 封面图URL。 + Cover string `json:"cover"` + // Bio 简短简介。 + Bio string `json:"bio"` + // Description 详细描述。 Description string `json:"description"` - CertType string `json:"cert_type"` // personal, enterprise - Stats Stats `json:"stats"` - IsFollowing bool `json:"is_following"` + // CertType 认证类型（personal/enterprise）。 + CertType string `json:"cert_type"` + // Stats 统计信息。 + Stats Stats `json:"stats"` + // IsFollowing 当前用户是否关注。 + IsFollowing bool `json:"is_following"` } type Stats struct { + // Followers 粉丝数。 Followers int `json:"followers"` - Contents int `json:"contents"` - Likes int `json:"likes"` + // Contents 内容数。 + Contents int `json:"contents"` + // Likes 累计点赞数。 + Likes int `json:"likes"` } diff --git a/backend/app/http/v1/dto/upload.go b/backend/app/http/v1/dto/upload.go index 10ac7d3..ec43101 100644 --- a/backend/app/http/v1/dto/upload.go +++ b/backend/app/http/v1/dto/upload.go @@ -1,24 +1,35 @@ package dto type UploadInitForm struct { - Hash string `json:"hash"` - Size int64 `json:"size"` + // Hash 文件哈希（用于秒传校验）。 + Hash string `json:"hash"` + // Size 文件大小（字节）。 + Size int64 `json:"size"` + // Filename 原始文件名。 Filename string `json:"filename"` + // MimeType 文件类型（如 image/png）。 MimeType string `json:"mime_type"` - Type string `json:"type"` + // Type 业务类型（如 cover/media/avatar）。 + Type string `json:"type"` } type UploadInitResponse struct { - UploadID string `json:"upload_id"` - Key string `json:"key"` // For S3 direct - ChunkSize int64 `json:"chunk_size"` + // UploadID 分片上传ID。 + UploadID string `json:"upload_id"` + // Key 对象存储Key（S3 直传使用）。 + Key string `json:"key"` + // ChunkSize 分片大小（字节）。 + ChunkSize int64 `json:"chunk_size"` } type UploadPartForm struct { - UploadID string `form:"upload_id"` - PartNumber int `form:"part_number"` + // UploadID 分片上传ID。 + UploadID string `form:"upload_id"` + // PartNumber 分片序号（从 1 开始）。 + PartNumber int `form:"part_number"` } type UploadCompleteForm struct { + // UploadID 分片上传ID。 UploadID string `json:"upload_id"` } diff --git a/backend/app/http/v1/dto/user.go b/backend/app/http/v1/dto/user.go index 39e0bb9..d0731cd 100644 --- a/backend/app/http/v1/dto/user.go +++ b/backend/app/http/v1/dto/user.go @@ -3,67 +3,109 @@ package dto import "quyun/v2/pkg/consts" type UserUpdate struct { - Nickname string `json:"nickname"` - Avatar string `json:"avatar"` - Gender consts.Gender `json:"gender"` - Bio string `json:"bio"` - Birthday string `json:"birthday"` - Location *Location `json:"location"` + // Nickname 昵称。 + Nickname string `json:"nickname"` + // Avatar 头像URL。 + Avatar string `json:"avatar"` + // Gender 性别（枚举）。 + Gender consts.Gender `json:"gender"` + // Bio 个人简介。 + Bio string `json:"bio"` + // Birthday 生日（YYYY-MM-DD）。 + Birthday string `json:"birthday"` + // Location 地区信息（省/市）。 + Location *Location `json:"location"` } type RealNameForm struct { + // Realname 真实姓名。 Realname string `json:"realname"` - IDCard string `json:"id_card"` + // IDCard 身份证号。 + IDCard string `json:"id_card"` } type WalletResponse struct { - Balance float64 `json:"balance"` + // Balance 账户余额（单位元）。 + Balance float64 `json:"balance"` + // Transactions 交易流水列表。 Transactions []Transaction `json:"transactions"` } type Transaction struct { - ID int64 `json:"id"` - Title string `json:"title"` + // ID 流水ID。 + ID int64 `json:"id"` + // Title 流水标题/描述。 + Title string `json:"title"` + // Amount 发生金额（单位元）。 Amount float64 `json:"amount"` - Type string `json:"type"` // income, expense - Date string `json:"date"` + // Type 流水类型（income/expense）。 + Type string `json:"type"` + // Date 发生时间（RFC3339）。 + Date string `json:"date"` } type RechargeForm struct { + // Amount 充值金额（单位元）。 Amount float64 `json:"amount"` - Method string `json:"method"` // wechat, alipay + // Method 充值方式（wechat/alipay）。 + Method string `json:"method"` } type RechargeResponse struct { + // PayParams 支付参数（透传给前端）。 PayParams string `json:"pay_params"` - OrderID string `json:"order_id"` + // OrderID 充值订单ID。 + OrderID string `json:"order_id"` } type Order struct { - ID int64 `json:"id"` - Type string `json:"type"` // consts.OrderType... - TypeDescription string `json:"type_description"` - CreateTime string `json:"create_time"` - PayTime string `json:"pay_time"` - Status string `json:"status"` - StatusDescription string `json:"status_description"` - Amount float64 `json:"amount"` - Quantity int `json:"quantity"` - Items []ContentItem `json:"items"` - TenantID int64 `json:"tenant_id"` - TenantName string `json:"tenant_name"` - IsVirtual bool `json:"is_virtual"` - BuyerName string `json:"buyer_name"` - BuyerAvatar string `json:"buyer_avatar"` - Title string `json:"title"` - Cover string `json:"cover"` + // ID 订单ID。 + ID int64 `json:"id"` + // Type 订单类型（内容购买/充值等）。 + Type string `json:"type"` + // TypeDescription 订单类型描述。 + TypeDescription string `json:"type_description"` + // CreateTime 创建时间（RFC3339）。 + CreateTime string `json:"create_time"` + // PayTime 支付时间（RFC3339）。 + PayTime string `json:"pay_time"` + // Status 订单状态。 + Status string `json:"status"` + // StatusDescription 订单状态描述。 + StatusDescription string `json:"status_description"` + // Amount 实付金额（单位元）。 + Amount float64 `json:"amount"` + // Quantity 内容数量。 + Quantity int `json:"quantity"` + // Items 订单内容明细。 + Items []ContentItem `json:"items"` + // TenantID 内容所属租户ID。 + TenantID int64 `json:"tenant_id"` + // TenantName 租户名称。 + TenantName string `json:"tenant_name"` + // IsVirtual 是否虚拟订单。 + IsVirtual bool `json:"is_virtual"` + // BuyerName 买家昵称。 + BuyerName string `json:"buyer_name"` + // BuyerAvatar 买家头像URL。 + BuyerAvatar string `json:"buyer_avatar"` + // Title 订单标题（用于列表展示）。 + Title string `json:"title"` + // Cover 订单封面图。 + Cover string `json:"cover"` } type Notification struct { - ID int64 `json:"id"` - Type string `json:"type"` - Title string `json:"title"` + // ID 通知ID。 + ID int64 `json:"id"` + // Type 通知类型（system/order/interaction）。 + Type string `json:"type"` + // Title 通知标题。 + Title string `json:"title"` + // Content 通知内容。 Content string `json:"content"` - Read bool `json:"read"` - Time string `json:"time"` + // Read 是否已读。 + Read bool `json:"read"` + // Time 发送时间（RFC3339）。 + Time string `json:"time"` }