2.3.1 礼包发放通知

  • 接入要求：礼包兑换功能必接。
  • 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.玩家在ulu提供的礼包兑换页输入我方运营发放的礼包CDK进行礼包兑换后,sdk server触发此通知。
  • 2.sdk server 会将玩家信息、用户填写的cdkCode和此cdkCode对应的giftCode发送给游戏 server。
  • 3.游戏 server在收到sdk server的数据后应分别按照相应的算法和密钥验证请求的合法性，再确认数据的正确性。
  • 4.游戏 server在确认请求无误后根据数据中玩家的区服角色数据直接向玩家发送giftCode所包含的道具。
  • 7.游戏 server在发送完道具后，返回给sdk server 成功或失败信息。
  • 8.sdk server根据返回的成功或失败信息进行处理，最终返回给sdk client 提示玩家兑换成功或失败。
  • 9.sign签名算法，详情请见2.4.2HMAC-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生成的cdk，玩家兑换时填写，与giftCode的关系为父(giftCode)子(cdkCode)关系。 eLxksa5m2GP24nH95JSs3
checkFlag 是 str(1) cdkCode是否为通用,0是，1否。什么是通用cdk:一个cdk可以为N个玩家所领取一次. 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 ""