MG+ K2 Common Wallet API Integration Quick Guide
MG+ K2 Common Wallet API Integration Quick Guide
Breadcrumbs

Sessions

此 API 生成游戏启动 URL。

  1. 找到您的API URL。可以在 MG+ 后台找到或由您的客户经理提供给您。

    image-20240327-075225.png

  2. 创建请求。

    1. 将 URL 替换为您的API URL并且将DemoAgent 替换成您的 Agent Code、testPlayer 替换成玩家帐号。

      1. 在请求范例中，这是端点的api-demo.k2net.io、DemoAgent、跟testPlayer部分。

    2. 将Authorization 令牌设定成您的STS令牌。

      1. 在请求范例中，这是Request Header的(STS Token)部分。

    3. 在Request Body:

      1. 将langCode替换成您要使用的语言及地区。

      2. platform 可以带入desktop 或 mobile。

      3. contentCode 代表要启动的游戏代码。

请求范例

POST https://api-demo.k2net.io/api/v1/agents/DemoAgent/players/testPlayer/sessions


Request Headers

Content-Type: application/x-www-form-urlencoded
Authorization: (STS Token)


Request Body

{
  langCode: "en-us"
  platform: "desktop"
  contentCode: "SMG_108Heroes"
}


  1. 取得回应。游戏启动网址会在 url 及 gameURL 栏位中回传(两栏位是相同的)。

回传范例

201 Response Body Example

{
  "url": "https://mnetroul.pauyolima.com/platform/default.aspx?applicationid=163&productId=34117&gameid=108heroesDesktop&brand=Brand&loginType=VanguardSessionToken&languageCode=en-us&externalToken=TOKEN&host=desktop&clienttypeid=70&launchHash=o3jpeLjuDgMfFBpyVxhTI4mMrFjEmv-MBZSbphOWByc",
  "gameURL": "https://mnetroul.pauyolima.com/platform/default.aspx?applicationid=163&productId=34117&gameid=108heroesDesktop&brand=Brand &loginType=VanguardSessionToken&languageCode=en-us&externalToken=TOKEN&host=desktop&clienttypeid=70&launchHash=o3jpeLjuDgMfFBpyVxhTI4mMrFjEmv-MBZSbphOWByc"
}


检查清单

  • 您是否使用了来自客户经理或 MG+ 后台的正确 API URL？
  • 您是否将/api/v1/放置在API URL 之后？
  • 您是否使用 POST 方法？
  • 您是否将 STS 令牌放入 Authorization 标头中？
  • 您是否将 langCode、platform 和 contentCode 放入请求中？
  • STS 令牌是否已过期？