【礼包直通车】接口功能说明
<p>[TOC]</p>
<h3>1、【礼包直通车】接口功能说明</h3>
<pre><code>用户在4399平台内领取礼包,4399平台调用乐玩提供的礼包下发接口,期间乐玩会转发调用CP方服务端礼包下发接口(需要CP方提供接口地址,详细接口文档见下方)</code></pre>
<p>时序图参考
<img src="https://f.abd001.com/common/show?f=cm1906555&s=9e43d4349b57aad800" alt="" /></p>
<ul>
<li>4399礼包直通车接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>CP方提供</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">gameid </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>游戏标识</td>
</tr>
<tr>
<td style="text-align: left;">uid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩平台uid</td>
</tr>
<tr>
<td style="text-align: left;">roleId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色ID</td>
</tr>
<tr>
<td style="text-align: left;">serverId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>服务器ID</td>
</tr>
<tr>
<td style="text-align: left;">giftId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>礼包标识(礼包类型,研发方提供)</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>时间戳,单位为:s</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名,签名方式见下说明</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>// 成功
{
"code": 10000,
"msg": "success",
"data": {}
}
// 异常
{"code": 10001, "msg": "params error"} // 参数错误
{"code": 10002, "msg": "sign error"} // 签名错误
{"code": 10003, "msg": "role dose not exists"} // 角色不存在
{"code": 10004, "msg": "gift dose not exists"} // 礼包不存在
{"code": 10005, "msg": "gift received"} // 礼包已领取过
{"code": 10006, "msg": "gift expired"} // 礼包已过期
{"code": 10007, "msg": "gift has gone"} // 礼包已领完
{"code": 11000, "msg": "other error"} // 其他错误</code></pre>
<h5>签名方式</h5>
<ul>
<li>签名方式:sign = MD5(SignString); </li>
<li>签名串生成方式:
<ul>
<li>所有参数除sign外,按key的字典序排序,以key=value的格式拼接字符串,并以&连接组成签名串,最后拼接服务端秘钥,例子见下:</li>
<li>秘钥:SERVER_KEY</li>
<li>SignString = "game=diaochan-weixin&giftId=111&roleId=abc&serverId=1001&timeStamp=1652000000&uid=1_1SERVER_KEY";</li>
<li>sign = MD5(game=diaochan-weixin&giftId=111&roleId=abc&serverId=1001&timeStamp=1652000000&uid=1_1SERVER_KEY)</li>
</ul></li>
</ul>