MG+ Free Games Plus Guide
Breadcrumbs

玩家优惠拒绝通知

当玩家在免费游戏优惠弹出屏幕上点击垃圾桶图标以拒绝优惠时,运营商应根据本指南中的详细说明,实施API以接收通知。

image-20250130-111823.png

API 集成流程

  1. 运营商向MG+提供API端点。

    1. 运营商必须提供总社端点。

    2. 如需特别通知主代理或代理,运营商必须为特定的主代理或代理提供相应的端点。

  2. 运营商将以下 IP 地址加入白名单:

    • 3.123.60.168/32

    • 18.193.63.102

    • 52.199.206.85/32

    • 54.64.194.205/32

  3. 配置完成后,运营商验证通知服务的功能。

端点设置

请根据以下详细规格设置一个端点,并将其传递给您的支持团队。

参数必须以驼峰命名法匹配,例如:agentCode。

端点 URL

  • Method: POST

  • Path: https://{endpoint}

名称

是否必填

资料类型

描述

agentCode

String (50)

代理的识别码。

offerGuid

GUID

MG+ 用于标识免费游戏优惠的唯一 GUID。

freeGameStatus

String (50)

必须为 userRejected - 此优惠状态表明玩家已拒绝该优惠。

instanceGuid

GUID

用于标识免费游戏实例的 MG+ 唯一 GUID。

playerId

String (50)

玩家的MG+识别码。

currencyCode

String (3)

代理币别。

请求范例

JSON
{
  "agentCode": "agent_123",
  "offerGuid": "2c123456-23a0-4bbf-a879-340c4a5d8e07",
  "freeGameStatus": "userRejected",
  "instanceGuid": "1234567e-511d-435e-9e62-63cf7f2f96e2",
  "playerId": "player_123",
  "currencyCode": "XS1"
}

回传范例

JSON
HTTP 200 - OK

错误处理

如果发生故障,MG+ 将在24小时内重新尝试请求。