syntax = "v1" info ( title: "代理服务（简化版）" desc: "新代理系统接口 - 系统简化后移除团队、返佣、升级、提现、实名、邀请码功能" version: "v1" ) // ============================================ // 公开接口（无需认证） // ============================================ @server ( prefix: api/v1/agent group: agent ) service main { // 获取推广链接数据 @handler GetLinkData get /link (GetLinkDataReq) returns (GetLinkDataResp) } @server ( prefix: api/v1/agent group: agent middleware: AuthInterceptor ) service main { // 申请成为代理（系统简化：无需邀请码） @handler ApplyForAgent post /apply (AgentApplyReq) returns (AgentApplyResp) } // ============================================ // 需要登录的接口 // ============================================ @server ( prefix: api/v1/agent group: agent jwt: JwtAuth middleware: UserAuthInterceptor ) service main { // 查看代理信息（简化版） @handler GetAgentInfo get /info returns (AgentInfoResp) // 获取代理仪表板数据（简化版） @handler GetAgentDashboard get /dashboard returns (AgentDashboardResp) // 生成推广链接 @handler GeneratingLink post /generating_link (AgentGeneratingLinkReq) returns (AgentGeneratingLinkResp) // 获取产品配置 @handler GetAgentProductConfig get /product_config returns (AgentProductConfigResp) // 获取收益信息（简化版） @handler GetRevenueInfo get /revenue returns (GetRevenueInfoResp) // 获取佣金记录 @handler GetCommissionList get /commission/list (GetCommissionListReq) returns (GetCommissionListResp) // 获取推广查询报告列表 @handler GetPromotionQueryList get /promotion/query/list (GetPromotionQueryListReq) returns (GetPromotionQueryListResp) // 创建提现申请 @handler CreateWithdraw post /withdraw/create (CreateWithdrawReq) returns (CreateWithdrawResp) // 获取提现记录列表 @handler GetWithdrawList get /withdraw/list (GetWithdrawListReq) returns (GetWithdrawListResp) } // ============================================ // 短链重定向接口（公开访问，不需要认证和api前缀） // ============================================ @server ( group: agent ) service main { // 短链重定向 @handler ShortLinkRedirect get /s/:shortCode returns (ShortLinkRedirectResp) } // ============================================ // 类型定义 // ============================================ type ( // 获取推广链接数据 GetLinkDataReq { LinkIdentifier string `form:"link_identifier"` // 推广链接标识 } GetLinkDataResp { AgentId string `json:"agent_id"` // 代理ID ProductId string `json:"product_id"` // 产品ID SetPrice float64 `json:"set_price"` // 代理设定价格 ActualBasePrice float64 `json:"actual_base_price"` // 实际底价 ProductName string `json:"product_name"` // 产品名称 ProductEn string `json:"product_en"` // 产品英文标识 SellPrice float64 `json:"sell_price"` // 销售价格（使用代理设定价格） Description string `json:"description"` // 产品描述 Features []Feature `json:"features"` // 产品功能列表 } // 申请成为代理 AgentApplyReq { Region string `json:"region,optional"` Mobile string `json:"mobile"` Code string `json:"code"` Referrer string `json:"referrer"` AgentCode int64 `json:"agent_code,optional"` } AgentApplyResp { AccessToken string `json:"accessToken"` AccessExpire int64 `json:"accessExpire"` RefreshAfter int64 `json:"refreshAfter"` AgentCode int64 `json:"agent_code"` } // 代理信息（简化版） AgentInfoResp { AgentId string `json:"agent_id"` Region string `json:"region"` Mobile string `json:"mobile"` WechatId string `json:"wechat_id"` AgentCode int64 `json:"agent_code"` } // 代理仪表板数据（简化版） AgentDashboardResp { Statistics DashboardStatistics `json:"statistics"` // 统计数据 PromotionLink string `json:"promotion_link"` // 推广链接 Product DashboardProduct `json:"product"` // 产品信息 } DashboardStatistics { TodayOrders int64 `json:"today_orders"` // 今日订单数 TodayEarnings string `json:"today_earnings"` // 今日佣金 MonthEarnings string `json:"month_earnings"` // 本月佣金 TotalOrders int64 `json:"total_orders"` // 总订单数 TotalEarnings string `json:"total_earnings"` // 总佣金 CommissionRate string `json:"commission_rate"` // 佣金率 CurrentBalance string `json:"current_balance"` // 当前余额 FrozenBalance string `json:"frozen_balance"` // 冻结余额 } DashboardProduct { Name string `json:"name"` // 产品名称 Price string `json:"price"` // 价格 Description string `json:"description"` // 描述 } // 生成推广链接 AgentGeneratingLinkReq { ProductId string `json:"product_id"` // 产品ID SetPrice float64 `json:"set_price"` // 设定价格 TargetPath string `json:"target_path,optional"` // 目标地址（可选，默认为推广报告页面） } AgentGeneratingLinkResp { LinkIdentifier string `json:"link_identifier"` // 推广链接标识 FullLink string `json:"full_link"` // 完整短链URL } // 产品配置 AgentProductConfigResp { List []ProductConfigItem `json:"list"` } ProductConfigItem { ProductId string `json:"product_id"` // 产品ID ProductName string `json:"product_name"` // 产品名称 ProductEn string `json:"product_en"` // 产品英文标识 ActualBasePrice float64 `json:"actual_base_price"` // 实际底价 PriceRangeMin float64 `json:"price_range_min"` // 最低价格 PriceRangeMax float64 `json:"price_range_max"` // 最高价格 PriceThreshold float64 `json:"price_threshold"` // 提价标准阈值 PriceFeeRate float64 `json:"price_fee_rate"` // 提价手续费比例 } // 收益信息（简化版） GetRevenueInfoResp { Balance float64 `json:"balance"` // 可用余额 TotalEarnings float64 `json:"total_earnings"` // 累计收益 CommissionTotal float64 `json:"commission_total"` // 佣金累计总收益 CommissionToday float64 `json:"commission_today"` // 佣金今日收益 CommissionMonth float64 `json:"commission_month"` // 佣金本月收益 } // 佣金记录 GetCommissionListReq { Page int64 `form:"page"` // 页码 PageSize int64 `form:"page_size"` // 每页数量 } GetCommissionListResp { Total int64 `json:"total"` // 总数 List []CommissionItem `json:"list"` // 列表 } CommissionItem { Id string `json:"id"` // 记录ID OrderId string `json:"order_id"` // 订单ID OrderNo string `json:"order_no"` // 订单号 ProductName string `json:"product_name"` // 产品名称 Amount float64 `json:"amount"` // 佣金金额 Status int64 `json:"status"` // 状态：1=已发放，2=已冻结，3=已取消 CreateTime string `json:"create_time"` // 创建时间 } // 推广查询列表 GetPromotionQueryListReq { Page int64 `form:"page"` // 页码 PageSize int64 `form:"page_size"` // 每页数量 } GetPromotionQueryListResp { Total int64 `json:"total"` // 总数 List []PromotionQueryItem `json:"list"` // 列表 } PromotionQueryItem { Id string `json:"id"` // 查询ID OrderId string `json:"order_id"` // 订单ID OrderNo string `json:"order_no"` // 订单号 ProductName string `json:"product_name"` // 产品名称 OrderAmount float64 `json:"order_amount"` // 订单金额 Amount float64 `json:"amount"` // 推广收益 QueryName string `json:"query_name"` // 查询人姓名 QueryMobile string `json:"query_mobile"` // 查询人手机号 CreateTime string `json:"create_time"` // 创建时间 QueryState string `json:"query_state"` // 查询状态 } // 短链重定向 ShortLinkRedirectResp {} // ============================================ // 提现相关 // ============================================ // 创建提现申请 CreateWithdrawReq { WithdrawAmount float64 `json:"withdraw_amount"` // 提现金额 AccountName string `json:"account_name"` // 收款人姓名 BankCardNumber string `json:"bank_card_number"` // 银行卡号 BankBranch string `json:"bank_branch,optional"` // 开户支行（可选） } CreateWithdrawResp { WithdrawId string `json:"withdraw_id"` // 提现记录ID } // 获取提现记录列表 GetWithdrawListReq { Page int64 `form:"page"` // 页码 PageSize int64 `form:"page_size"` // 每页数量 } GetWithdrawListResp { Total int64 `json:"total"` // 总数 List []WithdrawItem `json:"list"` // 列表 } WithdrawItem { Id string `json:"id"` // 记录ID WithdrawAmount string `json:"withdraw_amount"` // 提现金额 TaxAmount string `json:"tax_amount"` // 税费金额 ActualAmount string `json:"actual_amount"` // 实际到账金额 AccountName string `json:"account_name"` // 收款人姓名 BankCardNumber string `json:"bank_card_number"` // 银行卡号（脱敏） Status int64 `json:"status"` // 状态：0=待审核，1=已通过，2=已拒绝 AuditRemark string `json:"audit_remark"` // 审核备注 CreateTime string `json:"create_time"` // 创建时间 AuditTime string `json:"audit_time"` // 审核时间 } )