道具发放与模拟充值API
<p><strong>简要描述:</strong> </p>
<ul>
<li>服务端向游戏厂商发出请求发送道具发放,游戏厂商按照此接口说明完成处理并且返回结果</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>由游戏厂商提供</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST json</li>
</ul>
<p><strong>参数:</strong> </p>
<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;">player_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>发送道具的SDK帐号,(聚合登录时返回的唯一帐号标识)</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">JsonArray</td>
<td>查询条件json数组,接收时需要解析出json数组获取数据</td>
</tr>
<tr>
<td style="text-align: left;">service_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>玩家角色所在区服</td>
</tr>
<tr>
<td style="text-align: left;">role_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>角色ID,SDK内角色升级时所传递的角色ID</td>
</tr>
<tr>
<td style="text-align: left;">role_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>角色名,SDK内角色升级时所传递的角色名</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>当前操作时间戳,精确到秒,签名验证时请使用这个值</td>
</tr>
<tr>
<td style="text-align: left;">game_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>SDK接入参数,gameID</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>
<tr>
<td style="text-align: left;">mail_title</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>邮件标题,接口升级添加的参数,用于邮件发送时的标题,例如发放道具</td>
</tr>
<tr>
<td style="text-align: left;">mail_context</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>邮件内容,接口升级添加的参数,用于邮件发送时的内容,例如发放道具</td>
</tr>
</tbody>
</table>
<p><strong>data数据:</strong> </p>
<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;">pro_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>道具ID或充值商品ID,</td>
</tr>
<tr>
<td style="text-align: left;">pro_num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>道具数量</td>
</tr>
<tr>
<td style="text-align: left;">pro_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>道具名</td>
</tr>
<tr>
<td style="text-align: left;">pro_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>1,发放道具,2,模拟充值</td>
</tr>
<tr>
<td style="text-align: left;">pro_amount</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>平台定义的道具或模拟充值的RMB价值如:128.00</td>
</tr>
</tbody>
</table>
<p><strong>签名方法:md5(gameId+player_id+service_id+role_id+timestamp+gameKey),‘+’号不加入签名运算,签名结果中的英文字母为小写。</strong></p>
<p><strong>返回结果:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">空</th>
<th>默认</th>
<th>注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">Int</td>
<td style="text-align: left;">是</td>
<td></td>
<td>状态码 0,成功,其他失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td></td>
<td>状态说明</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>备注:无</p>
<p><strong>返回 结果 数组示例</strong></p>
</li>
</ul>
<pre><code>{
status:0
msg:"发放成功"
}</code></pre>
<p>请求示例</p>
<pre><code>{
player_id:"1085522",
service_id:"10",
role_id:"1000000000",
role_name:"梦江南",
game_id:260,
timestamp:1625536934,
sign:"adasdfasdfasdfadfasfsadfd",
data:[
{
pro_id:"100004",
pro_num:10,
pro_amount":"10",
pro_name:"3倍经验药水",
pro_type:1
},
{
pro_id:"111111",
pro_num:1,
pro_amount":"128.00",
pro_name:"模拟充值6元宝",
pro_type:2
},
]
}</code></pre>