大梦SDK服务端对接文档（官网）

1. 说明

该文档阅读对象为，游戏接入大梦sdk的后端开发人员。

包含IOS/ANDROID/微信小游戏/抖音小游戏/支付宝小游戏/美团小游戏/鸿蒙Next

2. 参数说明

需要先向运营人员索要对接参数，如果是微信小游戏，请注意使用我方提供的accesstoken地址获取accesstoken

3. 接口说明

一、登录校验

说明：客户端登录成功之后，在进入游戏之前由游戏后端调用，校验该次登录请求是否合法。

请求地址：

分配的对接参数中 - 登录验证地址

例如：http://xxx/login/check_login.php

请求方式：GET

参数说明：

字段	类型	说明
token	string	sdk登录返回给客户端的登录验证token，GET请求注意URL编码
appid	number	对接参数 - `appid`

接口返回（json）：

历史遗留会携带其他字段，只关注以下字段即可

字段	必选	类型	说明
ret	是	int	状态码0：成功，其他失败
info	是	string	错误说明信息
uin	是	string	用户标识 - 用于游戏关联
sessionKey	是	string	仅微信用户存在-微信sessionKey
openid	是	string	仅微信用户存在-微信openid
sdkAppid	否	string	仅微信用户存在-登录的appid
is_dy_app_user	否	int	是否是小手柄用户 -- 仅小手柄转移用户处理，1是，0否
dy_app_openid	否	string	小手柄用户openid -- 仅小手柄转移用户处理

二、充值回调

说明：玩家支付成功之后，SDK服务将通知游戏服务器发送道具

请求地址：游戏方提供给运营配置

请求方式：POST multipart/form-data

请求参数：

字段	必选	类型	说明
app_order_id	是	string	游戏方生成的订单
order_id	是	string	sdk侧生成的订单
amount	是	number	金额(元)，支付金额可能被篡改，建议提供商品配置表运营配置接口检查
order_time	是	int	订单创建时间
product_id	是	string	商品ID 数字类型，IOS历史遗留可能被强转0
from	是	string	支付来源，如果接入数据上报（DGA，XH）原样透传
sign	是	string	请求签名 - 见4.验签算法

支付来源说明：

如果我方投放上报/数据平台上报需要支付类型（商户类型）等，将from字段内容原样上报

from字段为支付来源，字符串包含 web:direct 为外切直冲，包含web为内切网页充值，包含apple为苹果内购

如果需要商户类型，判断 from字符串包含 wxmds为米大师支付，其他情况判断是否包含wx为微信支付，alipay为支付宝

返回结果（json）：

字段	必选	类型	说明
ret	是	int	状态码0：成功，其他失败

返回结果中必须包含ret字段,ret=0,为处理成功，其他为失败，sdk服务器将定期回调

三、激励视频播放完成回调（可选）

说明：接入激励视频的游戏，玩家观看视频成功之后，SDK服务将通知游戏服务器发送对应道具，

请求地址：游戏方提供，配置在sdk侧

目前仅支持APP端 tobid广告源

请求方式

POST application/x-www-form-urlencoded

请求参数：

字段	类型	说明
trans_id	string	唯一请求id，用于去重
appid	number	对接参数 - `appid`
uin	string	sdk用户标识
ad_type_id	string	广告类别ID
placement_id	string	广告位ID
network_id	string	广告平台ID
role_id	string	角色id
server_id	string	区服id
sign	string	请求签名 - 见4.验签算法

接口返回（json）：

字段	必选	类型	说明
ret	是	int	状态码0：成功，其他失败
info	是	string	错误说明信息

四、验签算法

验签秘钥使用对接参数-支付KEY

参数使用所有POST参数 - （存在后期添加参数的可能）

充值验签PHP代码示例

PHP会自动转换到$_POST,无需关注multipart/form-data

function makeSign($param, $secret)
{
    ksort($param);
    $query = "";
    foreach ($param as $key => $val) {
        if ($key != "sign") {
            $query .= ($key . "=" . $val . "&");
        }
    }
    $query .= "key=$secret";
    return strtoupper(md5($query));
}

后端对接文档

大梦SDK服务端对接文档（官网）#

1. 说明#

2. 参数说明#

3. 接口说明#

一、登录校验#

二、充值回调#

三、激励视频播放完成回调（可选）#

四、验签算法#