游戏销号周边通知接口（游戏侧）v1.4

1. 接口简介

  • 玩家在申请游戏账号注销且经过沉默期后 ，调用此接口，以通知计平、业务安全等周边业务进行账号相关信息的清理，一旦调用此正式环境的接口，将会开始清除周边系统现网数据，请谨慎调用（联调时建议使用测试账号）
  • odp进行服务申请 申请服务名：GACC帐号相关服务（gacc_account_service ）
  • 申请的接口：游戏销号周边通知接口
  • 申请方式参考：内网文档
  • 申请注明：使用方业务名称 ，使用背景 ，使用范围 ，申请的QPS量级

2. L5信息

  • 正式环境： 64620673:851968
  • 测试环境： 64620673:917504

3. 游戏销号接口

CGI基本信息

请求参数说明及完整示例

HEADER参数

参数 必填 值 说明
Content-Type 是 application/json application/json
X-Odp-Destination-Service 是 gacc_account_service 游戏销号周边通知服务名
X-Odp-Source-Service 是 示例：xxx 调用者服务英文名
X-Odp-Timestamp 是 示例：1540612023 当前服务器Unix秒
X-Odp-Nonce 是 示例：au8X6q 长度为6的随机字符串
X-Odp-Signature 是 xxxx 签名 
 签名计算方式：             lowercase(md5(strcat(destination,',',source,',',timestamp,',',nonce,',',secret)))
    destination为，
    source为, 
    timestamp为当前服务器Unix秒，
    nonce为长度为6的随机字符串，
    secret为调用方自身服务秘钥

POST参数

参数 类型 必填 说明
uin string 是 账号，qq号或openid
uinType string 是 如果账号是qq号则传"qq"，是openid传"openid"
gameId string 是 游戏id，如qldyx（权力的游戏）、smoba（王者荣耀），此对照表通过内网文档 获取，如有问题可联系fisherxiang
zoneId string 是 大区id，如果游戏不分区则传 -1
closeTime string 是 注销时间
appId string 是 手Q的vgameappid或微信的vgameappid
area string 是 服务器：1微信，2手Q
platid string 是 平台：0 ios，1 安卓
dimension string 是 1. openid
2. openid+platid
3. openid+roleid
4. openid+zoneid
5. openid+platid+roleid
6. openid+platid+zoneid
7. openid+platid+zoneid+roleid
将账号注销的维度对应代码填入，例如openid传1，openid+zoneid传3
roleId string 否 角色id
ext json 否 扩展字段，格式为json（预留） 
示例：
{
  "uin": "5053950",
  "uinType": "qq",
  "gameId": "dnf",
  "zoneId": "101",
  "closeTime": "2019-11-11 00:00:01",
  "roleId": "role123",
  "appId": "appId123",
  "area": "1",
  "platid": "0",
  "dimension": "3",
  "ext": {"aa":"aa","cc":"c"}}
}

完整请求示例：
curl -H "X-Odp-Destination-Service:gacc_account_service" -H "X-Odp-Source-Service:xxx" -H "X-Odp-Timestamp:xxx" -H "X-Odp-Nonce:xxx" -H "X-Odp-Signature:xxx" -d '{"uin": "5053950","uinType": "qq","gameId": "dnf","zoneId": "101","closeTime": "2019-11-11 00:00:01","roleId": "role123","dimension": "3","area": "1","appId": "platid","0": "appId123","ext": {"aa":"aa","cc":"c"}}' "http://ip:port/dmfeature/4037/accountCloseNotify"

返回字段说明及返回结果示例

返回参数

参数 类型 必填 说明
ret int 是 返回码
msg string 否 返回说明 
返回结果：
{
  "ret": 0,
  "msg": "success"
}

4. 返回码说明

ret 说明
0 请求成功
601 后端请求错误
603 请求参数错误
604 逻辑错误
605 其他错误
429 请求过载

results matching ""

    No results matching ""