微信游戏圈/QQ礼包
<p>[TOC]</p>
<h3>1、【微信游戏圈/QQ礼包】接口功能说明</h3>
<pre><code>用户在微信游戏圈/QQ内领取礼包，微信/QQ通知乐玩方，期间乐玩方会转发调用CP方服务端礼包下发接口（需要CP方提供接口地址，详细接口文档见下方）</code></pre>
<p>时序图参考
![]</p>
<h5>请求URL</h5>
<ul>
<li>CP方提供</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
<li>Content-Type:application/json</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;">game </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;">orderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求唯一标识，用于去除重复请求</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>礼包标识（CP定义好礼包ID给到乐玩即可）</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>// 成功
{
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;success&quot;,
}
// 异常
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;找不到角色信息&quot;} // 参数错误
</code></pre>
<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;">code </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>请求状态，1成功，非1值视为失败，乐玩方会按时间梯度尝试重发</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求结果说明</td>
</tr>
</tbody>
</table>
<h5>签名方式</h5>
<ul>
<li>同封禁请求[ <a href="https://www.showdoc.com.cn/p/85c2f3d8fe2f167177256afb9bd91118">https://www.showdoc.com.cn/p/85c2f3d8fe2f167177256afb9bd91118</a> ]</li>
</ul>