2.3.2 问卷奖励发放通知

  • 接入要求:问卷功能必接。
  • sdk版本:sdk2.x以上。

版本说明:

版本号 日期 说明
V1.0 2021-01-05 Sdk礼包发放初始版本
V1.1 2021-09-02 修改请求参数"sandbox"的数据类型
V1.2 2022-01-05 修改示例数据
V2.0 2023-06-02 优化描述

1 简要流程描述:

  • 1.玩家在填写完相关问卷调查提交成功后,sdk server触发此通知。
  • 2.sdk server 会将重要的玩家信息,giftCode发送给游戏 server。
  • 3.游戏 server在收到sdk server的数据后应分别按照相应的算法和密钥验证请求的合法性,再确认数据的正确性。
  • 4.游戏 server在确认请求无误后根据数据中玩家的区服角色信息直接向玩家发送giftCode所包含的道具。
  • 5.giftCode所包含的道具配置是在游戏方后台处理,处理完毕后将giftCode提供给我方运营人员。
  • 6.游戏 server在发送完道具后,返回给sdk server 成功或失败信息。
  • 7.sdk server根据返回的成功或失败信息进行处理,最终返回给sdk client 提示玩家兑换成功或失败。
  • 8.sign签名算法,详情请见2.4.2 HMAC-SHA256的sign签名算法示例

2 请求URL:

  • CP方提供

3 sdk server 请求方式:

  • POST

4 sdk server参数传递方式:

  • JSON

5 sdk server 请求参数:

参数名 必传 类型 说明 示例
uid str(50) ulu定义的用户id,唯一 1343444245255643138
roleId str(255) 角色id 1001200100001
serverId str(255) 服务器id 0001
giftCode str(255) 游戏方配置包含问卷奖励的礼包码 100120giftcode
cdkCode str(255) ulu方定义的礼包码,无含义参数 eLxksa5m2GP24nH95JSs3
checkFlag str(1) 固定值0无含义参数 0
sandbox int(1) 是否是沙盒环境,1:是沙盒环境,0:正式环境。 1
signature str(255) 验证签名,详情请看6.2 HMAC-SHA256的sign签名算法示例 b6befd6b3a3cfaf4aed1034ec13fad4d9c948dddcf5fb2868a06abe65a9faf54

6 sdk server发送的请求示例

{
    "uid":"1343444245255643138",
    "roleId":"1001200100001",
    "serverId":"0001",
    "giftCode":"100120giftcode",
    "cdkCode":"eLxksa5m2GP24nH95JSs3",
    "checkFlag":"0",
    "sandbox":1,
    "signature":"b6befd6b3a3cfaf4aed1034ec13fad4d9c948dddcf5fb2868a06abe65a9faf54"
}

7 游戏 server参数返回方式:

  • JSON

8 游戏 server 返回参数:

参数名 必传 类型 说明 示例
returnCode str(10) 请求结果代码:1为成功,其他为失败,失败代码请看11 1
returnMsg str(255) 请求结果描述 礼包发送成功
sendTime str(255) 成功时间戳-毫秒值,发送失败时可不传 1609313117837

9 游戏 server 返回示例

{
    "returnCode":"1",
    "returnMsg":"礼包发送成功",
    "sendTime":"1609313117837",
}

10 礼包发送returnCode代码

returnCode 说明
1 发送成功
MBP001 请求参数不全或参数长度/格式不正确,详情可通过returnMsg传递
MBP002 签名验证失败,详情可通过returnMsg传递
MBP003 查询玩家或服务器资料失败,详情可通过returnMsg传递
MBP004 查询礼包码资料失败,详情可通过returnMsg传递
MBP005 礼包道具发送请求超时,详情可通过returnMsg传递
MBP006 其他错误,运行时错误等,详情可通过returnMsg传递
MBP007 礼包已发放,详情可通过returnMsg传递

results matching ""

    No results matching ""