WEB游戏对接文档
<p>[TOC]</p>
<table>
<thead>
<tr>
<th>更新日期</th>
<th>更新说明</th>
<th>版本</th>
<th>作者</th>
</tr>
</thead>
<tbody>
<tr>
<td>2020-10-22</td>
<td>创建文档</td>
<td>1.0</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2020-11-01</td>
<td>登录,查角,充值接口中可以带区服变量</td>
<td>1.1</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2020-11-12</td>
<td>充值接口增加roleId参数</td>
<td>1.2</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2020-11-16</td>
<td>登录,查角接口增加gid参数</td>
<td>1.2.1</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2021-06-30</td>
<td>增加游戏内实名认证接口</td>
<td>1.2.2</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2021-07-15</td>
<td>更新充值接口roleId,productId说明</td>
<td>1.2.3</td>
<td>冯兴鑫</td>
</tr>
<tr>
<td>2022-02-16</td>
<td>增加游戏内接入扫码充值说明</td>
<td>1.2.4</td>
<td>张恒普</td>
</tr>
<tr>
<td>2023-12-27</td>
<td>优化聊天监控系统</td>
<td>1.2.5</td>
<td>冯兴鑫</td>
</tr>
</tbody>
</table>
<h1>一、接口要求和规范</h1>
<ul>
<li>参数 time 为Unix 时间戳(January 1 1970 00:00:00 GMT 起的秒数) ,单位为秒</li>
<li>编码统一使用 UTF-8</li>
<li>接口请求方式为 POST | GET</li>
<li>参数sign里的md5 加密的“+”号是字符串链接符号,并且要把md5后的字符串转成小写</li>
<li>key双方协定或是一方处理完知会另一方</li>
<li>接口地址中如果有区服变量,区服ID用字符串{$sid}代替,如 <a href="http://test-s{$sid}.test.com/login.php">http://test-s{$sid}.test.com/login.php</a></li>
</ul>
<h1>二、登录接口</h1>
<h4>接口说明:</h4>
<ul>
<li>玩家在平台选择游戏区并登录游戏时,平台将相关信息通过该登录接口发给游戏验证,待验证通过后将会引导玩家进入游戏界面,验证失败则会跳回平台出错页面(例如:官方网站)。</li>
</ul>
<h4>请求地址示例:</h4>
<ul>
<li><code>http://{$host}/{$api}?uid=2927&amp;platform=ludashi&amp;gid=xxx&amp;sid=1001&amp;time=1605507639&amp;fcm=1&amp;client=web&amp;sign=a782e874f87e1469c29d799b97dc7d1d</code></li>
</ul>
<h4>参数列表:</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>是否必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="http://{$host}/{$api">http://{$host}/{$api</a>}</td>
<td></td>
<td></td>
<td>游戏域名,最好是http。接口地址中如果有区服变量,区服ID用字符串{$sid}代替</td>
</tr>
<tr>
<td>uid</td>
<td>string</td>
<td>必须</td>
<td>玩家在平台的用户id</td>
</tr>
<tr>
<td>platform</td>
<td>String</td>
<td>必须</td>
<td>固定传ludashi, 标识平台</td>
</tr>
<tr>
<td>gid</td>
<td>string</td>
<td>必须</td>
<td>约定的game id, 如枪魂gid=qh,不参与sign验证</td>
</tr>
<tr>
<td>sid</td>
<td>int</td>
<td>必须</td>
<td>所属服务器,一区填写1,二区填写2,依此类推,</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>必须</td>
<td>平台服务器的时间戳(为长整数,单位为秒),游戏需根据此参数判断,请求参数是否过期</td>
</tr>
<tr>
<td>fcm</td>
<td>int</td>
<td>必须</td>
<td>防沉迷:1 已成年通过防沉迷;2 未成年,未满18岁;0 未填写身份信息</td>
</tr>
<tr>
<td>client</td>
<td>String</td>
<td>必须</td>
<td>网页:web;微端:pc;盒子:box</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>必须</td>
<td>md5(uid+platform+sid+time+fcm+client+key) 这里传递的md5字串为小写字母, 这里的key是表示平台和游戏双方提前协商约定好的密钥</td>
</tr>
</tbody>
</table>
<h1>三、角色查询</h1>
<h4>接口说明</h4>
<ul>
<li>查询用户角色是否存在,并且返回玩家角色信息。</li>
</ul>
<h4>请求地址示例:</h4>
<ul>
<li><code>http://{$host}/{$api}?uid=2927&amp;platform=ludashi&amp;gid=xxx&amp;sid=1&amp;time=1603333700&amp;sign=2d5f3d19c2169c53aa01b07cd2c92de2</code></li>
</ul>
<h4>请求参数:</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="http://{$host}/{$api">http://{$host}/{$api</a>}</td>
<td></td>
<td></td>
<td>查角接口地址。接口地址中如果有区服变量,区服ID用字符串{$sid}代替</td>
</tr>
<tr>
<td>uid</td>
<td>string</td>
<td>必须</td>
<td>平台用户标识</td>
</tr>
<tr>
<td>platform</td>
<td>String</td>
<td>必须</td>
<td>固定传ludashi, 标识平台</td>
</tr>
<tr>
<td>gid</td>
<td>string</td>
<td>必须</td>
<td>约定的game id, 如枪魂gid=qh,不参与sign验证</td>
</tr>
<tr>
<td>sid</td>
<td>int</td>
<td>必须</td>
<td>所属服务器,一区填写1,二区填写2,依此类推</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>必须</td>
<td>时间戳单位为秒</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>必须</td>
<td>md5(uid+platform+sid+time+key)这里传递的md5字串为小写字母, 这里的key是表示平台和游戏双方提前协商约定好的密钥</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;data&quot;: [
{
&quot;name&quot;: &quot;角色名&quot;,
&quot;level&quot;: &quot;1&quot;
}
],
&quot;msg&quot;: &quot;提示&quot;
}</code></pre>
<ul>
<li>注: name 和 level 必须返回</li>
</ul>
<h4>返回参数说明:</h4>
<table>
<thead>
<tr>
<th>errno</th>
<th>0:成功;非0失败</th>
</tr>
</thead>
<tbody>
<tr>
<td>data</td>
<td>每个角色信息里必须包含 name 和 level 字段</td>
</tr>
</tbody>
</table>
<h1>四、充值接口</h1>
<h4>接口说明:</h4>
<ul>
<li>玩家在平台充值成功后,由平台通过该充值接口向游戏发起发放游戏币的请求,在接口参数通过验证后,游戏向该服该玩家发放游戏币,并将元宝发放结果在接口中返回。</li>
</ul>
<h4>请求地址示例:</h4>
<ul>
<li><code>http://{$host}/{$api}?platform=ludashi&amp;orderId=1&amp;gid=testhdx&amp;sid=1&amp;uid=2927&amp;money=1&amp;coin=10&amp;time=1603334703&amp;sign=000faa216b879a6c8b3331d8b9eb84b7</code></li>
</ul>
<h4>请求方式:</h4>
<ul>
<li>GET</li>
</ul>
<h4>请求参数:</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>是否必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="http://{$host}/{$api">http://{$host}/{$api</a>}</td>
<td></td>
<td></td>
<td>充值接口地址。接口地址中如果有区服变量,区服ID用字符串{$sid}代替</td>
</tr>
<tr>
<td>platform</td>
<td>String</td>
<td>必须</td>
<td>固定传ludashi, 标识平台</td>
</tr>
<tr>
<td>orderId</td>
<td>string</td>
<td>必须</td>
<td>订单号,不允许重复支持 字母、数字、下划线</td>
</tr>
<tr>
<td>gid</td>
<td>string</td>
<td>必须</td>
<td>游戏ID;如《神王》传 wzzx</td>
</tr>
<tr>
<td>sid</td>
<td>int</td>
<td>必须</td>
<td>所属服务器,一区填写1,二区填写2,依此类推</td>
</tr>
<tr>
<td>uid</td>
<td>String</td>
<td>必须</td>
<td>平台用户标识</td>
</tr>
<tr>
<td>roleId</td>
<td>String</td>
<td>否</td>
<td>角色ID,透传role_id参数,方便固定金额充值</td>
</tr>
<tr>
<td>productId</td>
<td>String</td>
<td>否</td>
<td>商品ID,透传product_id参数,方便固定金额充值</td>
</tr>
<tr>
<td>money</td>
<td>float</td>
<td>必须</td>
<td>充值金额 单位元,支持两位小数</td>
</tr>
<tr>
<td>coin</td>
<td>int</td>
<td>必须</td>
<td>充值平台币数量</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>必须</td>
<td>平台服务器的时间戳(为长整数,单位秒)</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>必须</td>
<td>md5(platform+orderId+gid+sid+uid+ money+coin+time+key)这里传递的md5字串为小写字母, 这里的key是表示平台和游戏双方提前协商约定好的密钥</td>
</tr>
<tr>
<td>ext</td>
<td>string</td>
<td>否</td>
<td>透传参数</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;data&quot;: &quot;&quot;,
&quot;msg&quot;: &quot;提示&quot;
}</code></pre>
<h4>返回参数说明:</h4>
<table>
<thead>
<tr>
<th>errno</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>成功</td>
</tr>
<tr>
<td>1</td>
<td>订单号已存在(充值已成功)</td>
</tr>
<tr>
<td>-2</td>
<td>用户不存在</td>
</tr>
<tr>
<td>-3</td>
<td>IP限制</td>
</tr>
<tr>
<td>-4</td>
<td>md5校验错误</td>
</tr>
<tr>
<td>-5</td>
<td>time时间已过期 时间差在 前后3分钟内</td>
</tr>
<tr>
<td>-6</td>
<td>游戏服务器繁忙</td>
</tr>
<tr>
<td>-7</td>
<td>参数错误</td>
</tr>
</tbody>
</table>
<h4>充值接口其他要求:</h4>
<p>- 错误帐号不能充值,也就是不存在角色的账号。
- 同个订单号前面出错 要能补单。比如突然网络异常或者玩家输入错账号,充值接口返回充值失败。等接口正常后, 我们客服需要对这些失败的充值订单补单。</p>
<p><!--</p>
<h1>五、聊天信息推送接口</h1>
<h4>接口说明:</h4>
<ul>
<li>游戏方通过调用此接口,将玩家的聊天信息发送到鲁大师服务器</li>
</ul>
<h4>请求地址:</h4>
<ul>
<li><code>http://139.129.234.63:9952</code></li>
</ul>
<h4>请求方式:</h4>
<ul>
<li>POST | GET</li>
</ul>
<h4>请求参数:</h4>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>gid</td>
<td>String</td>
<td>是</td>
<td>平台游戏编号</td>
</tr>
<tr>
<td>sid</td>
<td>int</td>
<td>是</td>
<td>服务器编号</td>
</tr>
<tr>
<td>uid</td>
<td>string</td>
<td>是</td>
<td>平台用户ID,游戏登录接口中的平台账号</td>
</tr>
<tr>
<td>urole</td>
<td>string</td>
<td>是</td>
<td>游戏角色名称</td>
</tr>
<tr>
<td>channel</td>
<td>int</td>
<td>是</td>
<td>消息频道( 1私聊,2喇叭,4世界,6帮会,7队伍,8交易,9区域)</td>
</tr>
<tr>
<td>tid</td>
<td>string</td>
<td>是</td>
<td>私聊时的目标账号uid(平台用户ID),非私聊频道时传空字符串</td>
</tr>
<tr>
<td>trole</td>
<td>string</td>
<td>是</td>
<td>私聊时的目标角色名称,非私聊频道时传空字符串</td>
</tr>
<tr>
<td>body</td>
<td>string</td>
<td>是</td>
<td>urlencode后的消息内容 (不参与签名)</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>是</td>
<td>消息发送时间</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>是</td>
<td>加密信息 md5(gid+sid+uid+time+key)(body不参与验证)</td>
</tr>
<tr>
<td>platform</td>
<td>string</td>
<td>否</td>
<td>游戏平台,默认ludashi</td>
</tr>
<tr>
<td>vip</td>
<td>int</td>
<td>否</td>
<td>用户VIP等级,从0开始</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;errmsg&quot;: &quot;&quot;
}</code></pre>
<h4>返回参数说明</h4>
<table>
<thead>
<tr>
<th>错误码</th>
<th>提示</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>必填字段不能为空</td>
</tr>
<tr>
<td>2</td>
<td>游戏不存在</td>
</tr>
<tr>
<td>3</td>
<td>请求超时</td>
</tr>
<tr>
<td>4</td>
<td>签名错误</td>
</tr>
<tr>
<td>5</td>
<td>写入失败</td>
</tr>
<tr>
<td>6</td>
<td>IP限制, 请给运营提供贵方服务器IP地址(暂时不用)</td>
</tr>
</tbody>
</table>
<p>--></p>
<h1>五、游戏内封禁账号/解封账号/禁言/解除禁言</h1>
<h4>接口说明:</h4>
<ul>
<li>游戏方提供接口,平台访问此接口,对违规账号进行封禁或者禁言;</li>
</ul>
<h4>请求方式 :</h4>
<ul>
<li><code>POST | GET</code></li>
</ul>
<h4>请求地址示例:</h4>
<ul>
<li>禁言1个小时:</li>
<li>
<p><code>{api}?sid=38&amp;uid=46270981&amp;platform=ludashi&amp;action=unspeakable&amp;us_time=60&amp;time=1600240911&amp;sign=30a90efaf1d3f1064f1060f57db3babf</code></p>
</li>
<li>永久封禁账号:</li>
<li><code>{api}?sid=38&amp;uid=46270981&amp;platform=ludashi&amp;action=lock&amp;us_time=0&amp;time=1600242177&amp;sign=eb7ba76f10cb97558a9420e2ddefe791</code></li>
</ul>
<h4>请求参数 :</h4>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>是否必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="http://{$host}/{$api">http://{$host}/{$api</a>}</td>
<td></td>
<td></td>
<td>充值接口地址</td>
</tr>
<tr>
<td>sid</td>
<td>int</td>
<td>是</td>
<td>服务器编号</td>
</tr>
<tr>
<td>uid</td>
<td>string</td>
<td>是</td>
<td>平台用户ID,游戏登录接口中的平台账号</td>
</tr>
<tr>
<td>platform</td>
<td>string</td>
<td>是</td>
<td>ludashi 标记平台</td>
</tr>
<tr>
<td>action</td>
<td>string</td>
<td>是</td>
<td>lock :(永久封禁)封号+踢下线,unlock:解封,unspeakable:禁言,speakable:解除禁言</td>
</tr>
<tr>
<td>us_time</td>
<td>Int</td>
<td>否</td>
<td>禁言时间,单位分钟,只对禁言有效</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>是</td>
<td>消息发送时间</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>是</td>
<td>加密信息 md5(sid+uid+platform+action+us_time+time+key)转小写字母key为双方约定的,一般使用登录key</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;msg&quot;: &quot;&quot;
}</code></pre>
<h4>返回参数说明:</h4>
<table>
<thead>
<tr>
<th>错误码</th>
<th>提示</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>封禁成功</td>
</tr>
<tr>
<td>其他非0值</td>
<td>封禁失败,及失败原因</td>
</tr>
</tbody>
</table>
<h1>六、同步新区开服运营数据接口</h1>
<h4>接口说明:</h4>
<ul>
<li>区服开服当日,游戏方每隔10分钟请求此接口一次,同步新开区服的运营数据。由于数据包含次日留存,所以开服第三天需再调用接口,更新次日留存指标。</li>
</ul>
<h4>请求地址:</h4>
<ul>
<li><code>https://wan.ludashi.com/openApi/serverReport</code></li>
</ul>
<h4>请求方式:</h4>
<ul>
<li><code>POST</code></li>
</ul>
<h4>请求参数:</h4>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>gid</td>
<td>string</td>
<td>是</td>
<td>游戏ID,与鲁大师运营确认如《神王》wzzx</td>
</tr>
<tr>
<td>time</td>
<td>int</td>
<td>是</td>
<td>当前请求时间戳,3分钟有效</td>
</tr>
<tr>
<td>data</td>
<td>string</td>
<td>是</td>
<td>多条区服的更新数据集合,格式为urlencode后的json字符串。每条数据必须包含['sid', 'open_time', 'connect_num', 'register_num', 'create_role_num', 'create_role_rate', 'next_day_stay_rate','pay_user_num', 'gun_pay_user_num', 'create_role_pay_rate']解释见上面--data字段中各指标解释示例:%5B%7B%22sid%22%3A1%2C%22open_time%22%3A%222020-10-01+10%3A00%22%2C%22connect_num%22%3A1000%2C%22register_num%22%3A800%2C%22create_role_num%22%3A400%2C%22create_role_rate%22%3A0.5%2C%22next_day_stay_rate%22%3A0.3%2C%22pay_user_num%22%3A200%2C%22gun_pay_user_num%22%3A100%2C%22create_role_pay_rate%22%3A0.5%7D%2C%7B%22sid%22%3A2%2C%22open_time%22%3A%222020-10-02+10%3A00%22%2C%22connect_num%22%3A2000%2C%22register_num%22%3A800%2C%22create_role_num%22%3A400%2C%22create_role_rate%22%3A0.5%2C%22next_day_stay_rate%22%3A0.5%2C%22pay_user_num%22%3A100%2C%22gun_pay_user_num%22%3A30%2C%22create_role_pay_rate%22%3A0.25%7D%5D</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>是</td>
<td>MD5(gid+time+游戏登录key) 小写</td>
</tr>
</tbody>
</table>
<ul>
<li>sign校验key为游戏登录key</li>
</ul>
<h4>请求参数中data字段中各指标解释:</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th>参数解释</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">sid</td>
<td>区服ID</td>
<td>请传回登录游戏时,平台带的区服数字</td>
</tr>
<tr>
<td style="text-align: left;">open_time</td>
<td>开服时间</td>
<td>该区服的开服时间</td>
</tr>
<tr>
<td style="text-align: left;">connect_num</td>
<td>游戏链接数</td>
<td>当日链接访问该区服用户数(独立用户同一用户需要去重)</td>
</tr>
<tr>
<td style="text-align: left;">register_num</td>
<td>注册数</td>
<td>链接成功用户数(独立用户同一用户需要去重)</td>
</tr>
<tr>
<td style="text-align: left;">create_role_num</td>
<td>创角数</td>
<td>完成取名创角角色用户数</td>
</tr>
<tr>
<td style="text-align: left;">create_role_rate</td>
<td>创角率</td>
<td>创角数/注册数</td>
</tr>
<tr>
<td style="text-align: left;">next_day_stay_rate</td>
<td>次日存留</td>
<td>首日创角用户第二天登录数/首日创角用户数</td>
</tr>
<tr>
<td style="text-align: left;">pay_user_num</td>
<td>首日付费人数</td>
<td>该区服开服第一天,付费人数(单人多次付费算1人)</td>
</tr>
<tr>
<td style="text-align: left;">gun_pay_user_num</td>
<td>滚服付费人数</td>
<td>其他区服有付费再该区服付费人数</td>
</tr>
<tr>
<td style="text-align: left;">create_role_pay_rate</td>
<td>创角付费率</td>
<td>首日付费人数/首日创角人数</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;msg&quot;: &quot;&quot;
}</code></pre>
<h4>返回参数说明</h4>
<table>
<thead>
<tr>
<th>错我误码</th>
<th>提示</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>更改成功</td>
</tr>
<tr>
<td>其他非0值</td>
<td>失败</td>
</tr>
</tbody>
</table>
<h4>示例代码</h4>
<pre><code>$url = 'https://wan.ludashi.com/openApi/serverReport';
$reportData = [
['sid' =&gt; 1, 'open_time'=&gt;'2020-10-01 10:00','connect_num' =&gt; 1000, 'register_num' =&gt; 800,
'create_role_num' =&gt; 400, 'create_role_rate' =&gt; 0.5, 'next_day_stay_rate' =&gt; 0.3,
'pay_user_num' =&gt; 200, 'gun_pay_user_num' =&gt; 100, 'create_role_pay_rate' =&gt; 0.5],
['sid' =&gt; 2,'open_time'=&gt;'2020-10-02 10:00', 'connect_num' =&gt; 2000, 'register_num' =&gt; 800, 'create_role_num' =&gt; 400, 'create_role_rate' =&gt; 0.5, 'next_day_stay_rate' =&gt; 0.5,
'pay_user_num' =&gt; 100, 'gun_pay_user_num' =&gt; 30, 'create_role_pay_rate' =&gt; 0.25],
];
$param['data'] = urlencode(json_encode($reportData));
$param['gid'] = 'wzzx';
$param['time'] = time();
$key = 'login key';
$param['sign'] = strtolower(md5($param['gid'] . $param['time'] . $key));
$curlHandle = curl_init();
curl_setopt($curlHandle, CURLOPT_TIMEOUT, 5);
curl_setopt($curlHandle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curlHandle, CURLOPT_POST, true);
curl_setopt($curlHandle, CURLOPT_POSTFIELDS, http_build_query($param));
curl_setopt($curlHandle, CURLOPT_URL, $url);
curl_setopt($curlHandle, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curlHandle, CURLOPT_SSL_VERIFYHOST, false);
$result = curl_exec($curlHandle);
curl_close($curlHandle);
echo $result;</code></pre>
<h1>七、游戏内实名认证接口(选择接入)</h1>
<h4>接口说明:</h4>
<ul>
<li>游戏内弹出实名认证框,简化实名认证流程。</li>
</ul>
<h4>请求地址示例:</h4>
<ul>
<li><code>https://wan.ludashi.com/openApi/realAuth?uid=3233&amp;idcard=510104199003077014&amp;truename=张三&amp;type=yeyou&amp;gid=ltzn&amp;time=1625044377&amp;sign=fc2d7bb9e7383696d2ab57f17fbb0be2</code></li>
</ul>
<h4>请求参数:</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>uid</td>
<td>string</td>
<td>必须</td>
<td>平台用户标识,登录游戏时传入游戏方的用户标识</td>
</tr>
<tr>
<td>idcard</td>
<td>String</td>
<td>必须</td>
<td>玩家真实身份证</td>
</tr>
<tr>
<td>truename</td>
<td>string</td>
<td>必须</td>
<td>玩家真实姓名</td>
</tr>
<tr>
<td>type</td>
<td>string</td>
<td>必须</td>
<td>yeyou 页游; h5 H5游戏; client 端游</td>
</tr>
<tr>
<td>gid</td>
<td>string</td>
<td>必须</td>
<td>游戏id,向运营人员获取</td>
</tr>
<tr>
<td>time</td>
<td>Int</td>
<td>必须</td>
<td>当前请求的时间戳</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>必须</td>
<td>md5($uid.$type.$gid.$time.$key)md5字串为小写字母, key为登录游戏的key</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;msg&quot;: &quot;更新成功&quot;,
&quot;data&quot;: {
&quot;age&quot;: 23
}
}</code></pre>
<h4>返回参数说明:</h4>
<table>
<thead>
<tr>
<th>errno</th>
<th>0:成功;非0失败</th>
</tr>
</thead>
<tbody>
<tr>
<td>data</td>
<td></td>
</tr>
<tr>
<td>msg</td>
<td>提示</td>
</tr>
</tbody>
</table>
<h1>八、游戏内扫码支付</h1>
<h3>接入方式一</h3>
<h4>接口说明:</h4>
<ul>
<li>通过iframe或者其他方式直接加载鲁大师提供支付页面</li>
</ul>
<h4>请求示例:</h4>
<ul>
<li><code>https://wan.ludashi.com/h5pay/platform?game_id=ms&amp;server_id =1848&amp;uid=93 </code></li>
</ul>
<h4>请求参数</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>game_id</td>
<td>string</td>
<td>必须</td>
<td>游戏id,向运营人员获取</td>
</tr>
<tr>
<td>server_id</td>
<td>int</td>
<td>必须</td>
<td>游戏区服id,</td>
</tr>
<tr>
<td>uid</td>
<td>int</td>
<td>必须</td>
<td>鲁大师游戏用户id</td>
</tr>
</tbody>
</table>
<h3>接入方式二</h3>
<h4>接口说明:</h4>
<ul>
<li>通过鲁大师游戏提供接口获取签名字符串与支付页面拼接成一个完整的url,将url渲染成二维码供用户扫码</li>
</ul>
<h4>请求示例:</h4>
<ul>
<li><code>https://wan.ludashi.com/ajax/Geth5pay</code></li>
</ul>
<h4>参数说明:</h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>game_id</td>
<td>String</td>
<td>必须</td>
<td>游戏id,向运营人员获取</td>
</tr>
<tr>
<td>server_num</td>
<td>Int</td>
<td>必须</td>
<td>游戏区服id,</td>
</tr>
<tr>
<td>uid</td>
<td>Int</td>
<td>必须</td>
<td>鲁大师游戏用户id</td>
</tr>
<tr>
<td>money</td>
<td>Int</td>
<td>可选</td>
<td>充值金额(单位:元),固定金额充值必传</td>
</tr>
<tr>
<td>product_id</td>
<td>Int</td>
<td>可选</td>
<td>商品ID,固定金额充值必传</td>
</tr>
<tr>
<td>product_name</td>
<td>String</td>
<td>可选</td>
<td>商品名称,固定金额充值必传</td>
</tr>
<tr>
<td>role_id</td>
<td>Int</td>
<td>可选</td>
<td>角色ID,固定金额充值必传</td>
</tr>
<tr>
<td>role_name</td>
<td>String</td>
<td>可选</td>
<td>角色名称,固定金额充值必传</td>
</tr>
<tr>
<td>ext</td>
<td>String</td>
<td>可选</td>
<td>透传参数</td>
</tr>
</tbody>
</table>
<h4>返回示例:</h4>
<pre><code>{
&quot;errno&quot;: 0,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;sign&quot;: &quot;84457fe11037d2ee166c382d9cf7e478&quot;,
&quot;url&quot;: &quot;http://wan.ludashi.com/h5pay/index&quot;
}
}
## 渲染二维码URL示例:
## http://wan.ludashi.com/h5pay/index?sign=84457fe11037d2ee166c382d9cf7e478</code></pre>
<h4>备注</h4>
<ul>
<li>针对部分非固定充值金额游戏存在固定金额充值需求时,在渲染二维码URL上加上change=0参数即可</li>
</ul>