接入说明 (必看)

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

商户须知

  • 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

integer

错误编码，为1时表示调用正常，接口返回数据将放在data参数中

msg

string

错误信息

data

object

返回的数据

PreviousMini.Game API对接文档Next通用错误码

Last updated