查询活动流程资格

接口说明

此接口旨在查询用户在特定活动下的流程参与资格。通过该接口，可以获取用户在指定周期内已经使用的资格数量以及剩余的参与资格。

场景：

• 流程前验证：在调用活动流程之前，使用此接口可以判断用户是否还具备参与资格，从而避免无效的操作或提示用户相应的信息。
• 页面展示：当加载活动页面时，可以调用此接口来实时展示给用户他们在当前周期内还剩下多少次参与资格，增强用户体验。

请求示例

curl "https://s1.livelink.qq.com/livelink/?apiName=ApiActionActQuas&livePlatId=egame&gameId=ty&t=1657791571&nonce=bHYyWpNb&actId=1001&v=2.0&code=0prleGC4uUiuAGdsDjgEzJa0%3D&sig=e16c73ae0018a91b25e9077f24ad3"
 -d '{"flows":"69f33ur0,u9c4su5j"}'

参数	类型	说明
flows	string	要查询的流程ID，支持多流程ID查询，多个流程ID之间用英文","分割

注意事项

• 此流程仅限于读取和输出接口数据。
• 请勿将此流程配置为执行具有写性质的接口功能，包括但不限于扣除积分、发放道具等。

输出举例

{
  "apiName": "ApiActionActQuas",
  "iRet": 0,
  "jData": {
    "69f33ur0": {
      "used": 0,
      "left": 1,
      "interval": "month",
      "chance": 1
    },
    "u9c4su5j": {
      "used": 14,
      "left": 16,
      "interval": "day",
      "chance": 1
    }
  },
  "sMsg": "ok",
  "tid": "240007785784342937",
  "v": 1
}

返回说明

参数	类型	说明
u9c4su5j	string	返回中的key部分，代表需要查询的一个flowID
used	int	用户已参与的次数
left	int	剩余次数
interval	string	周期类型。可能的值: once:活动周期内 day:每天 week:每周 month:每月 为空:无资格限制
chance	int	周期内总次数