云积分查询

接口说明

此接口用于查询指定平台UID所绑定的游戏账号的积分信息。通过调用该接口，开发者可以获取到用户游戏账号当前的积分情况，以便于后续的业务逻辑处理，如积分兑换、积分排名等。接口将返回与UID相关联的游戏账号的积分数据，若查询成功，将返回具体的积分值；若查询失败或UID未绑定游戏账号，则返回相应的错误信息。

请求示例

curl "https://s1.livelink.qq.com/livelink/?
apiName=ApiRequest&livePlatId=xx&actId=1201&gameId=cf&v=2.0&t=&nonce=&code=diVa28UpyL5G%2BVmKNVIcg%3D%3D&sig=e3909d0a2cb7f7d8f2ec03fb4ea96007" -d '{"flowId":"69f33ur0"}'

先决条件

• 示例中ID为：69f33ur0 的流程需要由腾讯游戏来联人员在流程结果配置中配置"云积输出(2.0版本)"

注意事项

• 云积分是腾讯专有的游戏道具，仅限于已绑定的游戏角色使用。
• 腾讯游戏内，云积分具有通用性。游戏一旦为用户发放积分，腾讯游戏即可对这些积分进行查询和扣除操作。

输出举例

{
  "iRet": 0, 
  "v":2,
  "apiName":"JFCloud",
  "jData": {
    "110": {  
      "all": 35, 
      "left": 2 
    },
    "111": {
      "all": 41,
      "left": 23
    }
  },
  "sMsg": "ok",
  "tid": "173629138131790391"
}

jData字段说明

• 积分ID如110和111用于区分不同类型的积分，例如日常签到积分和充值积分，它们可用于不同的兑换活动。
• all字段：不可修改，只增不减，用于记录用户在此积分上的总值
• left字段代表用户当前可用的积分数量，这个数值可以根据用户的使用情况进行增减，通常用于积分兑换等实际操作。