服务器接入文档

用户信息校验接口

用户校验接口是游戏服务端验证用户合法性的接口。需要游戏服务端调用SDK服务端接口，并根据返回结果确认用户是否合法

Host

• platform.hoolai.com（国内游戏）
• global-platform.hoolai.com（海外游戏）

协议

• Http
• https

方法

• POST

路径

• /official/original/validateAccessToken

请求头

• Content-Type: application/json
• X-ACCESS-TOKEN: 客户端登录获取到的accessToken,()

请求参数

参数名	类型	描述
productId	Integer/int	游戏产品ID, 客户端初始化回调参数[gameId]
channel	String/string	游戏渠道（sdk 渠道key）, 客户端初始化回调参数[channel]
channelId	Integer/int	渠道ID, 客户端初始化回调参数[channelId]
loginUid	Long	当前登录用户id, 客户端登录成功回调参数[uid]

请求响应

• 正确响应

{
    "code": "SUCCESS",
    "sign": "0daa95c4f278a77ceaadb01b62896a12.1650942836",
    "value": "T0s=",
    "desc": "SUCCESS",
    "group": "SUCCESS"
}

• 错误响应

{
    "code": "AUTHORIZE_INFO_ERROR",
    "requestId": null,
    "exceptionId": null,
    "desc": "授权信息不正确",
    "group": "gateway"
}

注意

上面只是授权信息不正确的示例，错误响应只是其中一种

支付订单通知接口

接口主要是客户端支付结束后通过此接口通知游戏此订单已完成支付来进行发货操作（）

协议

• HTTP
• HTTPS

方法

• GET

请求参数

参数名	类型	示例	描述
order_id	String	0C7F3AFA0C404901B4A2CE056F79198C	SDK平台订单号
channel	String	hoolai/hoolaiappstore/xiaomi/xxxx	sdk平台渠道标识
product_id	String	1/11/212/xxx	游戏产品ID（sdk平台）
channel_id	String	12129/12144/xxx	游戏渠道ID（sdk平台）
uid	String	209879034/248596079/xxxxx	用户平台UID
pay_date	String	2022-05-07 13:25:55	用户支付日期时间
amount	String	60/99/64800/xxxx	支付金额(常用单位100)，如元100、美元*100等
currency	String	CNY/USD/TWD/EUR/xxxx	常用单位（元/美元/欧元/等）
callback_info	String	MTExMTE./xxxxx	游戏透传参数Base64后（客户端支付接口的传入的callback_info， 但是需要先base64解码, 解码前请将字符串里的‘−' 换成 '+' , '_' 换成 '/', '.' 换成‘='号 (请忽略单引号)。 注意：callback_info最长为50位，字符类型没有限制）
sign	String	d02ffcb1e9bb55853e0891577304b58d	所有参数（不包括sign）key进行字典排序后拼接product_key=sdk提供密钥进行MD5签名例如：md5(key=value&key=value&key=value...&product_key=xxxx)

游戏接口响应

响应结果示例

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 08 Jun 2015 11:27:44 GMT
Content-Type: text/html;charset=UTF-8
Connection: keep-alive

• 响应body为ok(不区分大小写)即为通知成功，否则sdk会进行多次重复尝试，尝试间隔为(秒): 一共13次，13次后仍然未成功通知则sdk会停止通知并标记为未通知到账订单，需要运营在管理台进行手动发货处理。

活动订单通知接口

接口是客户端参加CDK等活动成功后通过此接口通知游戏此活动订单进行发放奖励操作

协议

• HTTP
• HTTPS

方法

• GET

请求参数

参数名	类型	示例	描述
order_id	String	0C7F3AFA0C404901B4A2CE056F79198C	SDK活动订单号
channel	String	hoolai/hoolaiappstore/xiaomi/xxxx	sdk平台渠道标识
product_id	String	1/11/212/xxx	游戏产品ID（sdk平台）
channel_id	String	12129/12144/xxx	游戏渠道ID（sdk平台）
uid	String	209879034/248596079/xxxxx	用户平台UID
pay_date	String	2022-05-07 13:25:55	用户支付日期时间
goods_id	String	200001	活动的奖励编号
role_id	String	1234567	游戏的角色ID
sign	String	d02ffcb1e9bb55853e0891577304b58d	所有参数（不包括sign）key进行字典排序后拼接product_key=sdk提供密钥进行MD5签名例如：md5(key=value&key=value&key=value...&product_key=xxxx)

游戏接口响应

响应结果示例

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 08 Jun 2015 11:27:44 GMT
Content-Type: text/html;charset=UTF-8
Connection: keep-alive

• 响应body为ok(不区分大小写)即为通知成功，否则sdk会进行多次重复尝试，尝试间隔为(秒): 一共13次，13次后仍然未成功通知则sdk会停止通知并标记为未通知到账订单，需要运营在管理台进行手动发货处理。