Files
novatask/doc/api/stakepoint.api
2025-05-29 15:51:28 +08:00

84 lines
2.7 KiB
Plaintext
Raw Permalink 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.

syntax = "v1"
@server (
prefix: /gapi/stakepoint/v1
jwt: Auth
group: stakepoint
)
service novatask {
@doc "获取质押档位列表"
@handler GetStakeLevelList
get /level (GetStakeLevelListReq) returns (GetStakeLevelListResp)
@doc "质押积分操作"
@handler StakePoint
post /stake (StakePointReq)
@doc "积分质押日志列表"
@handler GetStakeLogList
get /log (GetStakeLogListReq) returns (GetStakeLogListResp)
}
type GetStakeLevelListReq {
RoleID int64 `form:"role_id"` // 角色id
}
type PointStakeLevel {
Id int `json:"id"` // 档位id
Title string `json:"title"` // 档位标题
ElfName string `json:"elf_name"` // 精灵名称
Level int `json:"level"` // 精灵等级
Points int `json:"points"` // 积分数量
Days float64 `json:"days"` // 质押天数
RenewDays float64 `json:"renew_days"` // 续期天数
Rate float64 `json:"rate"` // 返利比率
}
type StakeLevel {
Id int `json:"id"`
Title string `json:"title"` // 档位标题
Level int `json:"level"` // 精灵等级
ElfName string `json:"elf_name"` // 精灵名称
Points int `json:"points"` // 积分数量
Days float64 `json:"days"` // 质押天数
RenewDays float64 `json:"renew_days"` // 续期天数
StartTime int64 `json:"start_time"` // 开始时间
EndTime int64 `json:"end_time"` // 结束时间
CanRenew bool `json:"can_renew"` // 是否可续约
}
type GetStakeLevelListResp {
State int `json:"state"` // 状态1表示已开启可质押 0表示不可质押
Staking *StakeLevel `json:"staking,optional"` // 质押中的档位信息
RenewLevel *StakeLevel `json:"renew_level,optional"` // 已续约的档位信息
Levels []PointStakeLevel `json:"levels"` // 档位列表
}
type StakePointReq {
RoleID int64 `json:"role_id"` // 角色id
LevelId int `json:"level_id"` // 档位id
Action int `json:"action"` // 操作类型1表示质押2表示升级质押 3表示续约
}
type GetStakeLogListReq {
RoleID uint64 `form:"role_id,optional"` // 角色id
Page int `form:"page"` // 页码
Size int `form:"size"` // 每页数量
}
type StakeLog {
Id uint `json:"id"` // id
RoleID uint64 `json:"role_id"` // 角色id
LevelId uint `json:"level_id"` // 档位id
Level uint `json:"level"` // 精灵等级
Points int `json:"points"` // 积分数量
Action uint8 `json:"action"` // 操作类型1=质押2=升级3=续约4=解除
CreatedAt int64 `json:"created_at"` // 创建时间
}
type GetStakeLogListResp {
Total int `json:"total"` // 总数
List []StakeLog `json:"list"` // 列表
}