当玩家在免费游戏优惠弹出屏幕上点击垃圾桶图标以拒绝优惠时,运营商应根据本指南中的详细说明,实施API以接收通知。
API 集成流程
-
运营商向MG+提供API端点。
-
运营商必须提供总社端点。
-
如需特别通知主代理或代理,运营商必须为特定的主代理或代理提供相应的端点。
-
-
运营商将以下 IP 地址加入白名单:
-
3.123.60.168/32
-
18.193.63.102
-
52.199.206.85/32
-
54.64.194.205/32
-
-
配置完成后,运营商验证通知服务的功能。
端点设置
请根据以下详细规格设置一个端点,并将其传递给您的支持团队。
参数必须以驼峰命名法匹配,例如:agentCode。
端点 URL
-
Method:
POST -
Path: https://{endpoint}
|
名称 |
是否必填 |
资料类型 |
描述 |
|---|---|---|---|
|
agentCode |
是 |
String (50) |
代理的识别码。 |
|
offerGuid |
是 |
GUID |
MG+ 用于标识免费游戏优惠的唯一 GUID。 |
|
freeGameStatus |
是 |
String (50) |
必须为 |
|
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小时内重新尝试请求。