进入游戏

接入方向MINI.GAME平台发起用户进入游戏请求,MINI.GAME平台返回游戏生成好的游戏客户端url

Entergame

该API接口由MINI.GAME平台提供,由接入方进行调用

POST {MINIGAME_APIURL}/api/game/v1/entergame?trace_id=your_trace_id

{MINIGAME_APIURL}为MINI.GAME接口域名,可通过后台获得

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

签名算法请查阅 签名算法及示例 页面描述

Body

Name	Type	Description
appid	string	商户的唯一标识 可通过商户后台获得
timestamp	integer	时间戳(秒)
token	string	用户在MINI.GAME平台的token,可以通过获取玩家鉴权token接口获得
currency	string	货币名称，详情查看货币列表支持的货币的name字段
gameid	string	进入的游戏id
lang	string 非必填	游戏语言，默认为en
screen_mode	string	游戏类型为彩票游戏才需要传送屏幕模式，1=>全屏，2=>半屏( 显示在手机屏幕下半部分)

接入方请求参数示例

{
    "appid": "13",
    "token": "50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "currency":"usdt",
    "lang": "en",
    "gameid": "9",
    "timestamp": 1711954264
}

MINI.GAME平台响应参数示例

success

{
    "data": {
        "gameurl":"https://***.mini.game?xxx=xxx"
    },
    "code": 0,
    "msg": "ok"
}

fail

{
    "code": 10002,
    "msg": "sign invalid"
}

成功返回示例的参数说明

参数名	必选	类型	说明
data	是	object	返回的数据
gameurl	是	string	打开游戏客户端的url，打开游戏客户端的url.彩票类型的游戏，半屏的时候需要添加底部安全区域，需要url里添加bh=height。height为底部安全区高度像素
code	是	integer	状态码
msg	是	string	提示信息

★彩票游戏添加底部安全区域说明★：

用于部分手机机型添加底部安全区域高度。

gameurl返回参数： https://[url]?[param] 如：可调整为 https://[url]?bh=50&[param] ，为底部安全区高度为50像素.

错误码

更多返回错误代码请查阅 通用错误码 页面描述