龙域世界
物料说明
| 物料变量 | 说明 |
|---|
| host | 接口请求地址（找运营或商务获取） |
| platform | 平台标识（找运营或商务获取） |
| sec_key | 加密密钥（找运营或商务获取） |
| chathost | 游戏方给平台推送聊天数据的平台接口路径地址 |
接口签名示例
$params = [
'user' => 460234,//平台用户uid
'time' =>1699254443,//登录请求时间戳秒
'server_sn' => s60004,//区服
'sec_key' => {sec_key},//加密密钥
];
$signstr = $params['user'] . $params['time'] . $params['server_sn'] . self::$_game['sec_key'];
//转化为小写
$signstr = strtolower($signstr));
//使用md5加密生成签名串
$token = md5($signstr);
1.游戏登录【必接】
接口描述
该接口用于对接用户登录游戏，最终接口调用后会获取一个进入游戏的链接地址，您可以通过iframe的方式嵌入到您的游戏平台，完成游戏加载
接口请求地址
- https://{host}/gateway/login/
接口请求方式
接口请求参数
| 参数 | 类型 | 是否必填 | 字段释义 | 示例 |
|---|
| platform | string | 是 | 平台标识找运营索要 | 默认51 |
| user | string | 是 | 平台对应用户uid | 4523616 |
| server_sn | string | 是 | 区服标识 如s1,s2,s3,s4,…,sn | s6 |
| server_sn_int | string | 是 | 区服标识数字类型 | 6 |
| goods_sign | string | 是 | 研发方使用的游戏区服id | 1006 |
| time | int | 是 | 当前登录时间戳 | 169924172 |
| fcm | int | 是 | 是否完成中宣部实名认证过,1: 已认证，2：未认证 | 1 |
| ishaiwai | int | 是 | 是否是海外默认为0，非海外 | 0 |
| client | int | 是 | 客户端标识，pc端默认传递0，1：微端 | 0 |
| bindtel | int | 是 | 是否绑定手机号 | 0 :未绑定，1：已绑定 |
| wtchan | string | 是 | 渠道外投标识，默认传递0 | 0 |
| token | string | 是 | token校验串具体参考下面签名校验 | a8a02712f8619501d10b8819bf3edb52 |
接口对接示例
https://{host}/gateway/login/{platform}?platform=51&server_sn=s60004&server_sn_int=60004&goods_sign=60004&user=460235689&fcm=1&client=0&time=1699241729&token=a8a02712f8612201d1338819bf3edb35&ishaiwai=0&bindtel=1&wtchan=0
2.充值发货【必接】
接口描述
该接口用于给游戏用户发送钻石礼包，您可以在需要的地方进行调用，如充值完成发货后调用
接口请求方式
接口请求地址
- https://{host}/gateway/sendgoods/
接口请求参数
| 参数 | 类型 | 是否必填 | 字段释义 | 示例 |
|---|
| spid | string | 是 | 平台标识找运营索要 | 平台标识 |
| account | string | 是 | 账号 | 4523616 |
| sid | string | 是 | 区服id | 1006 |
| orderid | string | 是 | 平台订单id | a8a02712f8619501d10b8819bf3edb52 |
| price | string | 否 | 充值金额 | 6 |
| time | int | 是 | 当前登录时间戳 | 169924172 |
| token | string | 是 | token校验串具体参考下面签名校验 | a8a02712f8619501d10b8819bf3edb52 |
接口实例
3.查询角色信息（等级/战力）【必接】
接口描述
该接口用于给游戏用户发送钻石礼包，您可以在需要的地方进行调用，如充值完成发货后调用
接口请求方式
接口请求地址
- https://{host}/gateway/userinfo/
接口请求参数
| 参数 | 类型 | 是否必填 | 字段释义 | 示例 |
|---|
| user | string | 是 | 平台对应用户uid | 4523616 |
| areasign | string | 是 | 研发方使用的游戏区服id | 1006 |
| time | int | 是 | 当前登录时间戳 | 169924172 |
| sign | string | 是 | 接口请求签名 | a8a02712f8619501d10b8819bf3edb52 |
接口实例
4.禁言/封号/解禁/解封接口【必接】
接口描述
该接口用于的账号封禁，禁言，解禁，解封，您可以在平台需要的地方进行调用
接口请求方式
接口请求地址
- https://{host}/gateway/api/{platform}/ban
接口请求参数
| 参数 | 类型 | 是否必填 | 字段释义 | 示例 |
|---|
| account | string | 是 | 平台对应用户uid | 4523616 |
| action | string | 是 | 行为类型 | unspeakable:禁言,speakable：解除禁言,lock:封号,unlock：解封号 |
| server_id | string | 是 | 区服id | 1006 |
| role_id | string | 是 | 角色id | 1006 |
| banday | string | 是 | 操作用户天数 | 1 |
| time | int | 是 | 当前登录时间戳 | 169924172 |
| sign | string | 是 | 接口请求签名 | a8a02712f8619501d10b8819bf3edb52 |
接口实例
5.聊天推送【选接】
接口描述
1.该接口用于游戏主动给对接平台推送用户聊天数据，属于选择对接。对接后平台将会主动推送玩家聊天数据。2.接口实现由平台提供，游戏对接方实现。
接口请求方式
接口请求地址
接口请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|
| sid | 是 | int | 区服id必填 |
| role_id | 是 | string | 角色id |
| role_name | 是 | string | 角色名称 |
| account | 是 | string | 用户账号id |
| ip_addr | 是 | string | 用户ip地址 |
| channel | 是 | int | 频道id,1：世界,2区域,3喇叭,4私聊,5队伍,6行会 |
| chat_content | 是 | string | 聊天内容 |
| sec_chat_role_name | 是 | string | 私聊角色名称 |
| server_open_days | 是 | int | 开服第几天 |
| from_vip_level | 是 | int | 说话者vip等级 |
| from_level | 是 | int | 说话者游戏等级 |
| receiver_user | 是 | string | 聊天对象的账号 |
| receiver_vip_level | 是 | int | 聊天对象的vip等级 |
| receiver_level | 是 | int | 聊天对象的游戏等级 |
| add_time | 是 | int | 发送时间时间戳 单位豪秒 |
6.游戏内充值二维码获取【必接】
接口描述
该接口用于用户游戏内点击充值按钮，弹出支付二维码，需要平台提供生成充值二维码的接口，具体对接方式根据对接实际情况进行调整。
