USDK国内接入文档


角色查询接口

<h3>角色查询接口</h3> <p>接口地址:<code>由游戏厂商提供</code> 验证地址由SDK对接时提供</p> <ul> <li> <h4>接口请求方式</h4> <p>post/get</p> </li> <li> <h4>接口数据格式</h4> <p>key-vaule</p> </li> <li> <h5>接口参数</h5> </li> </ul> <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_id</td> <td style="text-align: left;">int</td> <td style="text-align: left;">否</td> <td>聚合游戏id</td> </tr> <tr> <td style="text-align: left;">server_id</td> <td style="text-align: left;">int</td> <td style="text-align: left;">否</td> <td>游戏区服id</td> </tr> <tr> <td style="text-align: left;">player_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">否</td> <td>聚合玩家账号id</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">int</td> <td style="text-align: left;">否</td> <td>时间戳(加密验证使用)</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string</td> <td style="text-align: left;">否</td> <td>签名,使用MD5加密,签名序列规则(+为连接符):MD5(game_id +server_id + player_id + timestamp + game_key)</td> </tr> </tbody> </table> <ul> <li>备注:无</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> <th>注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">int</td> <td style="text-align: left;">否</td> <td></td> <td>错误码 200:验证成功 ;其他都为失败</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td style="text-align: left;">否</td> <td></td> <td>信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">string</td> <td style="text-align: left;">否</td> <td></td> <td>data返回的就是玩家可以进行购买的礼包</td> </tr> <tr> </tr> </tbody> </table> <ul> <li>返回示例:{&quot;code&quot;:&quot;1000&quot;,&quot;message&quot;:&quot;成功&quot;,&quot;roles&quot;:[{&quot;role_uid&quot;:&quot;123&quot;,&quot;role_name&quot;:&quot;哈哈&quot;,&quot;roleLevel&quot;:&quot;100&quot;},{&quot;role_uid&quot;:&quot;424&quot;,&quot;role_name&quot;:&quot;哈哈2&quot;,&quot;roleLevel&quot;:&quot;100&quot;}]}</li> </ul> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">返回值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">● 成功示例:{&quot;code&quot;:&quot;1000&quot;,&quot;message&quot;:&quot;成功&quot;,&quot;roles&quot;:[{&quot;role_uid&quot;:&quot;123&quot;,&quot;role_name&quot;:&quot;哈哈&quot;,&quot;roleLevel&quot;:&quot;100&quot;},{&quot;role_uid&quot;:&quot;424&quot;,&quot;role_name&quot;:&quot;哈哈2&quot;,&quot;roleLevel&quot;:&quot;100&quot;}]}</td> <td style="text-align: left;">请求成功</td> </tr> <tr> <td style="text-align: left;">{code = 10001, message = &quot;other&quot;}</td> <td style="text-align: left;">其他错误</td> </tr> <tr> <td style="text-align: left;">{code = 10002, message = &quot;token&quot;}</td> <td style="text-align: left;">签名错误</td> </tr> <tr> <td style="text-align: left;">{code = 10003, message = &quot;params&quot;}</td> <td style="text-align: left;">参数错误</td> </tr> <tr> <td style="text-align: left;">{code = 10005, message = &quot;player&quot;}</td> <td style="text-align: left;">角色信息错误</td> </tr> </tbody> </table>

页面列表

ITEM_HTML