# 平台运营能力接入
# 背景
腾讯游戏来联使用平台能力发放平台道具
在一些联合活动的场景中,需要涉及到平台侧自己的道具发放(如用户完成某任务后如混合发放腾讯的游戏道具和平台道具),另外还需要根据平台侧提供的条件确定是否能做道具发放(例如完成了平台的某个任务才能发腾讯游戏道具),所以这里提供了一套接口协议,平台侧按接口协议实现接口并提供给 腾讯游戏来联,腾讯游戏来联 侧会完成平台接口接入
# 示例
如图所示,平台活动页面调用腾讯游戏来联接口同时发放平台侧和游戏侧道具

如图所示,游戏活动页面调用腾讯游戏来联接口检查平台任务是否完成

# 统一接口规范
通用参数统一放在querystring
。在腾讯游戏来联调用平台接口时默认携带以下通用参数。
字段名称 | 字段类型 | 字段是否必填 | 字段说明 |
---|---|---|---|
appId | string | 是 | 平台向腾讯游戏来联申请的唯一英文标识 |
t | int | 是 | 当前UNIX时间戳(秒) |
nonce | string | 是 | 随机字符串,建议为8位包含大小写字母和数字的组合 |
sign | string | 是 | 请求签名信息。将querystring中所有参数按键名称部分使用ASCII排序,将所有的值中间用"+"拼接起来,再用"+"拼接body部分json字符串,最后用"+"拼接腾讯游戏来联分配的签名密钥,得到的数据md5后转小写字母 例如: querystring: appId=livelink&t=1652098836&nonce=11223344 body: {"a":"b"} 步骤一:str = "livelink+11223344+1652098836+{"a":"b"}" 步骤二:str += "+xxxxxx"(xxxxxx为livelink分配给平台的签名密钥) 步骤三:sign = strtolower(md5(str)) |