接入说明 (必看)

本页面详细介绍了平台接入公共参数,签名算法,多语言配置,通用错误码等说明,接入前请先详细阅读本页面。

商户须知

• MINI.GAME服务器时区：UTC+0，接入方需注意数据统计的时区计算

• MINI.GAME平台返回的token有效期为七天，每次重新进入（登录）后 会重新获取

• 审核通过开户要求后，我方将提供商户后台账号，商户可通过后台查看app_id（商户号）和 key（签名密钥）

• 文档中{MINIGAME_APIURL}需替换为在商户后台界面提供的测试/生产环境接口调用地址，查看商户运营后台-设定-API接入配置-MINIGAME_APIURL，MINIGAME提供给接入方的接口。

• 文档中{ACCESS_URL}配置位置：商户运营后台-设定-API接入配置-ACCESS_URL，用于MINIGAME回调接入方接口。

• 文档中{BACKEND_URL}配置位置：商户运营后台-设定-API接入配置-BACKEND_URL，用于接入方查询MINIGAME数据。

• MINI.GAME提供的接口code=0表示成功，要求接入方实现的接口code=1表示成功

---

公共参数

MINI.GAME平台调用接入方所有API接口调用均会包含

参数	所处位置	必填	类型	说明
sign	header	是	string	签名算法见 签名算法及示例
trace_id	url params	是	string	由接入方自己定义生成，每个请求的trace_id都是唯一的值

---

签名算法及示例

sign=md5(url上的参数+body中的josn字符串+签名密钥key)

注意这里的body中的json字符串必须是请求中最原始的body中的字符，不能使用json包转出来之后的字符，最终使用小写输出

例如：

类型	值
请求url	{MINIGAME_APIURL}/api/Balance/GetBalance?trace_id=dhf1aboc1iio
请求方式	POST
Content-Type	"application/json; charset=utf-8"
请求body中json数据	{“player_logon_token”:”b27cfe9b-f01c-11ee-a0b5-000c2901d9cc”,”account_id”:”1002402”,”timestamp”:1711971655}
签名密钥key	39a6581c31ef3203a22edb2daa2ab6d1
需要md5加密的字符串	trace_id=dhf1aboc1iio{“player_logon_token”:”b27cfe9b-f01c-11ee-a0b5-000c2901d9cc”,”account_id”:”1002402”,”timestamp”:1711971655}39a6581c31ef3203a22edb2daa2ab6d1
最终加密出来md5字符串	e3f8dc79e875e46f6755ef540c2d24f3

特别说明

基于性能考量， 使用page和size参数进行分页的时候， 我方并不返回总页数， 需要自行循环至无数据为止，并且一次性查询条数最大为5000。

调用返回

当平台返回的http code为200时，为HTTP访问API正常，可正常解析返回结果。其余http错误时为链路异常。 返回的Content-Type为 "application/json; charset=utf-8"

{
    "code": 1,
    "msg": "success",
    "data": {
        "glist": [
            {
                "gameid": "2000002",
                "name": "Mines",
                "platform": "1",
            }
        ]
    }
}

参数名	类型	说明
code	integer	错误编码，为1时表示调用正常，接口返回数据将放在data参数中
msg	string	错误信息
data	object	返回的数据