流程条件判定

接口说明

• 本接口专为腾讯游戏来联提供的流程设计，旨在快速检测用户是否能满足特定流程的条件要求。
• 调用此接口后，将直接返回true或false的判定结果。若用户未能通过腾讯游戏来联侧的流程条件判定，该接口还将额外返回具体的未通过原因，帮助用户或开发者快速定位问题。。
• 本接口适用于所有已支持的流程查询操作，无需额外配置或设置。

请求示例

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

先决条件

• 假设流程ID：y790xrew 已配置完成并在线。该流程不能配置为"输出条件信息"
• 此时必须将请求中的apiName=ApiRequest修改为FlowTaskQuery可快速获取流程条件的判定结果。

判定规则

• 若流程中未设定任何条件，则此判定将默认返回true。
• 用户的参与资格次数亦作为判定依据。例如，若某流程规定每个用户仅可参与一次，当用户已参与过，判定将返回false。
• 本方法仅用于判定用户是否满足参与资格，并不会触发实际执行操作。 注意：判定过程不涉及发货道具的总剩余量以及个人礼包领取次数的上限。如道具已售罄，但此接口返回仍然会判定为true。

判定举例

用于快速为用户判定该流程是否可以执行通过。 举例，腾讯游戏来联侧流程配置为：当天击败5人，则领取A礼包，每人每天可领取1次。

• 用户当天未参与活动。击败4人。判定为：false，提示：不满足击杀次数。
• 用户当天未参与活动。击败5人。判定为：true，提示：ok。
• 用户当天已参与活动。击败5人。判定为：false，提示：资格已耗尽。

输出举例

{
    "iRet": 0,
    "v":2,
    "apiName": "FlowTaskQuery",
    "jData":{"flowVal":true, "reason":"ok","code": 0},
    "sMsg": "ok",
    "tid": "173629138131790391"
}

字段说明

参数	类型	说明
flowVal	bool	表示流程中的条件部分是否得到满足。
reason	string	默认值：“ok”。若用户未通过条件判定，此处将填写未通过的具体原因，原因提示文字可由腾讯游戏来联人员自定义配置。
code	int	整型数值，对reason字段进行补充说明。

以下是code值及其对应含义，需要开发者特别关注：

• 0: 用户满足流程条件，若使用该流程为用户发货，可直接进行。按钮显示为“可领取”。
• -16005: 用户资格不符。可能是因为流程设置了参数次数限制，而用户已达到该流程的参数上限。按钮显示为“已领取”。
• -1: 用户未达到条件。例如，若领取条件要求用户当天必须登录，而用户未登录，则返回此值。按钮显示为“未达成条件”。
• -4011:访问过于频繁。建议用户稍后重试。
• -4014:账号角色信息已失效，建议用户重新绑定账号。

补充举例

• 场景1: 当用户符合参与的基本条件，但因其已参与过该活动而资格受限时，code将返回-16005，表明用户已达到参与次数上限。
• 场景2: 当用户既符合参与条件又具备参与资格（即尚未参与过活动）时，code将返回0，同时flowVal将为true，表示用户可以正常参与活动。
• 场景3: 如果用户不满足参与条件，并且尚未参与过活动，code将返回-1，指示用户未达到活动参与的基本要求。
• 场景4: 在罕见情况下，如果用户既不满足条件又已参与过活动，code仍然返回-16005，因为资格问题优先于条件不满足的情况。这表示尽管用户未满足条件，但更关键的是他们已经用尽了参与资格。