274 lines
9.4 KiB
Plaintext
274 lines
9.4 KiB
Plaintext
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"` // 审核时间
|
||
}
|
||
)
|