企业微信接口生成二维码时，如何动态设置有效期和扫描次数限制？

Question

在使用企业微信接口生成二维码时，如何动态设置二维码的有效期和扫描次数限制是一个常见问题。虽然企业微信API支持生成永久二维码和限时二维码，但扫描次数限制需通过业务逻辑实现。例如，可利用数据库记录每次扫描行为，结合二维码参数判断是否超出设定次数。对于有效期设置，可通过API的expire_seconds字段指定二维码过期时间，最大为2592000秒（30天）。实际开发中，需综合考虑二维码类型、业务需求及用户场景，合理配置相关参数，确保二维码既满足使用要求又具备安全性。此外，还需注意捕获API返回的错误信息，及时调整二维码生成策略。

Answer 1

1. 企业微信二维码生成基础

在使用企业微信接口生成二维码时，首先需要明确二维码的两种主要类型：永久二维码和限时二维码。永久二维码没有时间限制，而限时二维码可以通过API的expire_seconds字段指定过期时间，最大为2592000秒（30天）。以下是生成二维码的基本步骤：

• 调用企业微信API获取access_token。
• 根据业务需求选择二维码类型（永久或限时）。
• 通过POST请求传递参数至API接口。

对于开发者来说，理解这些基本概念是实现动态设置有效期和扫描次数限制的前提。

2. 动态设置二维码有效期

通过企业微信API中的expire_seconds字段，可以灵活设置二维码的有效期。以下是一个示例代码片段，展示如何生成一个有效时间为7天的二维码：

import requests
import json

def create_qrcode(expire_seconds):
    access_token = "your_access_token"
    url = f"https://qyapi.weixin.qq.com/cgi-bin/qrcode/create?access_token={access_token}"
    data = {
        "action_name": "QR_STR_SCENE",
        "action_info": {
            "scene": {"scene_str": "test_scene"}
        },
        "expire_seconds": expire_seconds
    }
    response = requests.post(url, data=json.dumps(data))
    return response.json()

# 示例：生成7天有效期二维码
result = create_qrcode(604800)
print(result)

需要注意的是，expire_seconds的最大值为2592000秒，超出范围将导致API返回错误信息。

3. 扫描次数限制的业务逻辑实现

企业微信API本身不支持直接设置二维码的扫描次数限制，但可以通过结合数据库记录每次扫描行为来实现这一功能。以下是具体实现步骤：

1. 创建数据库表用于存储二维码参数及扫描记录。
2. 在用户扫描二维码时，查询数据库判断是否已超出设定次数。
3. 如果未超出限制，则允许继续操作并更新扫描次数；否则提示用户二维码已失效。

以下是一个简单的数据库表结构设计：

字段名	类型	说明
id	INT	主键，自增
scene_id	VARCHAR(255)	二维码场景ID
scan_limit	INT	最大扫描次数
current_scan	INT	当前扫描次数

4. 综合考虑与错误处理

实际开发中，需综合考虑二维码类型、业务需求及用户场景，合理配置相关参数。例如，在促销活动场景下，可以设置二维码的有效期为1天，扫描次数限制为5次，以确保资源分配合理且安全可控。

此外，还需注意捕获API返回的错误信息。以下是一个可能的错误码及其含义：

• 40014: access_token无效或已过期。
• 41003: 参数错误。
• 42003: 二维码已过期。

针对上述错误，可以通过重试机制或调整参数重新生成二维码。

5. 流程图分析

为了更清晰地描述整个流程，以下是一个mermaid格式的流程图：

graph TD;
    A[开始] --> B{选择二维码类型};
    B --永久--> C[生成永久二维码];
    B --限时--> D[设置expire_seconds];
    D --> E[生成限时二维码];
    F[扫描二维码] --> G{是否超过扫描次数};
    G --否--> H[允许访问];
    G --是--> I[提示二维码失效];