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:
3 sdk server 请求方式:
4 sdk server参数传递方式:
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参数返回方式:
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传递 |