v2.3.9
<p>[TOC]</p>
<h1>绑定银行卡[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/bank/addCard</td>
<td style="text-align: left;">请求中增加一个字段</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">+ email string // 邮箱 新增</code></pre>
<h1>获取用户VIP信息[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/account/getVipData</td>
<td style="text-align: left;">应答中新增字段</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">CurrLvlDay int `json:"curr_lvl_day"` // 表示vip当前等级下已进行的天数
LvlUpNeedDay int `json:"lvl_up_need_day"` // 表示当前等级升级到下一级需要的总天数,如果为0,表示已经满级</code></pre>
<h1>VIP等级加速准备</h1>
<p><strong>客户端点击加速按钮,向服务器请求得到所需金币值</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/vip/speedup_ready</td>
<td style="text-align: left;">无</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 请求 无
// 应答
&struct {
NeedCoin int `json:"need_coin"`
Items []proto.VipRightsItem `json:"items"` // 参加下面结构
}
type VipRightsItem struct {
Id int `json:"id"`
Name string `json:"name"` // 效果名
Effect string `json:"effect"` // svga url
}
需要特别处理的错误码:
</code></pre>
<h1>VIP等级加速确定</h1>
<p><strong>客户端确认VIP等级加速</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/vip/speedup_confirm</td>
<td style="text-align: left;">无</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 请求 无
// 应答
struct {
NewLv int `json:"new_lv"`
OldLv int `json:"old_lv"`
SvgaId int `json:"svgaId"` // 升级动效Id
UpEffect string `json:"up_effect"` // 升级动效
Result bool `json:"result"`
}</code></pre>
<h1>VIP变化的通知[协议调整]</h1>
<pre><code class="language-go">Id: -313
msg:
IsVip bool `json:"is_vip"`
VipLvl int `json:"vip_lvl"`
CurrLvlExp int `json:"curr_lvl_exp"`
LvlupExp int `json:"lvlup_exp"`
CurrLvlDay int `json:"curr_lvl_day"` // 新增
LvlupNeedDay int `json:"lvlup_day"` // 新增 本级升到下一级所需总天数</code></pre>
<h1>添加提领方式[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/bank/addCard</td>
<td style="text-align: left;">1支持添加Paypal方式,2禁止添加bank_card</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">card_type 参数支持 paypal</code></pre>
<h1>提现提示信息[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/bank/getDrawInfo</td>
<td style="text-align: left;">1增加paypal方式的文案</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 增加回应字段
+ PaypalText string `json:"paypal_text"`</code></pre>
<h1>提现接口[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/bank/withdraw</td>
<td style="text-align: left;">禁止银行卡提现</td>
</tr>
</tbody>
</table>
<h1>获取绑定卡信息[协议调整]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/bank/getCards</td>
<td style="text-align: left;">过滤掉绑定的银行卡信息</td>
</tr>
</tbody>
</table>
<h1>房间内H5入口列表[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/room/H5Entities</td>
<td style="text-align: left;">无</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 请求参数 无
// 应答
array []H5Entity // 数组形式返回
type H5Entity struct {
Name string `json:"name"`
IconUrl string `json:"icon_url"`
H5Url string `json:"h5_url"`
}</code></pre>
<h1>摩天轮H5游戏-信息[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/web/game/ferrisWheel/info</td>
<td style="text-align: left;">尽量兼容别人的协议</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
uid int64
round int64
// 出参
Select map[string]int `json:"select"` // 当前的选中
Countdown int `json:"countdown"` // 当前的倒计时
Avatar string `json:"avatar"` // 头像 (小图)
Nick string `json:"nick"` // 昵称
Coin int `json:"gold"` // 现有金币数
Round int64 `json:"round"` // 当前的轮数 (别人的协议是 string 类型)
TimeUnix int64 `json:"time"` // 当前时间戳 (别人的协议是 string 类型)
Profit int64 `json:"profit"` // 当日收益
Result string `json:"result,omitempty"` // 指定局的结果
ResultList []string `json:"resultList"` // 最近5次的结果列表
WinCoin int64 `json:"winGold,omitempty"` // 指定局收益
Top []FerrisTopItem `json:"top,omitempty"` // 指定局赢的最多的前三名
type FerrisTopItem struct {
UserId int64 `json:"uid"` // uid
UserNo int `json:"userNo"` // userno
Avatar string `json:"avatar"` // 头像 (小图)
Nick string `json:"nick"` // 昵称
Gender int `json:"gender"` // 性别
Level int `json:"level"` // 等级(我们的user没有等级概念) 目前赋值的 赢的金币
Rank int `json:"rank"` // 排名
}</code></pre>
<h1>摩天轮H5游戏-下注[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/web/game/ferrisWheel/choice</td>
<td style="text-align: left;">尽量兼容别人的协议</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
uid int64
choice string
gold int
round int64
// 出参
ok:bool</code></pre>
<h1>摩天轮H5游戏-记录[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/web/game/ferrisWheel/bill</td>
<td style="text-align: left;">尽量兼容别人的协议</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
服务器目前写死最近100条
uid int64
// 出参
[]FerrisBillItem{} // 数组结构, 结构先下面
type FerrisBillItem struct {
Id int64 `json:"id"` // id
UserId int64 `json:"uid"` // uid
Choice string `json:"choice"` // 选择
Result string `json:"result"` // 本局结果
Coin int `json:"gold"` // 下注
Multiple int `json:"multiple"` // 倍率
CreateTime int64 `json:"createTime"` // 下注时间
}</code></pre>
<h1>摩天轮H5游戏-日榜[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/web/game/ferrisWheel/rank</td>
<td style="text-align: left;">尽量兼容别人的协议</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">服务器目前写死top100
// 入参 无
// 出参
[]FerrisTopItem{} // 数组结构 结构见下面
type FerrisTopItem struct {
UserId int64 `json:"uid"` // uid
UserNo int `json:"userNo"` // userno
Avatar string `json:"avatar"` // 头像 (小图)
Nick string `json:"nick"` // 昵称
Gender int `json:"gender"` // 性别
Level int `json:"level"` // 等级 啥等级
Rank int `json:"rank"` // 排名
}</code></pre>
<h1>摩天轮H5游戏-日榜3与奖励配置[新增]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/web/game/ferrisWheel/day_rank</td>
<td style="text-align: left;">尽量兼容别人的协议</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参 无
// 出参
TopList []FerrisTopItem `json:"top3List"` // 结构上面找
AwardList []biz.FerrisAward `json:"top3Awards"` // 结构见下面
type FerrisAward struct {
Id int `json:"awardId"` // 商城物品Id
Name string `json:"name"` // 奖品名称
Num int `json:"num"`
}</code></pre>
<h1>公会成员冻结钻石</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/sys/bank/unionFrozenDiamond</td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
unionId int64 // 工会ID
referDiamond int64 // 参考值(大于等于此值的钻石才冻结)
// 出参
ok:bool </code></pre>
<h1>公会成员清理掉冻结的钻石</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/sys/bank/unionFrozenClean</td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
unionId int64 // 工会ID
// 出参
ok:bool </code></pre>
<h1>获取遇见列表[优化]</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">接口名</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">/v1/user/getMeetUsers2</td>
<td style="text-align: left;">新增接口</td>
</tr>
</tbody>
</table>
<pre><code class="language-go">// 入参
limit int // 要多少条数据
offset int // 偏移, 当客户端首次启动时,赋值0; 当客户端左翻右翻时 ++1 给服务器传过来.
// 出参
Users []*proto.User `json:"users"`
Offset int `json:"offset"` // 新增, 客户端每次调完接口 用服务器返回的offset覆盖客户端自己的offset.</code></pre>