在 Make、n8n 或 Zapier 里用一个 HTTP 步骤生成二维码

2026-10-12 · 更新于 2026-10-26 api automation make n8n zapier no-code

要在 Make、n8n 或 Zapier 的工作流里生成二维码，只需加一个 HTTP 请求步骤，向 QR Maker REST API 发送 POST，带上目的地链接和触发这个工作流的那条记录的 ID。返回结果里有要印刷的短链接，需要的话还有 SVG 图片。因为有 ID，请求可以安全重试，同一条记录让工作流跑了两次，也不会生成两个码。

这些工具里没有专门的 QR Maker 应用。你也不需要：三个工具都有通用的 HTTP 步骤，而且在哪个工具里请求都一样。

请求内容

方法：POST
网址：https://qrmaker.ai/api/v1/qrcodes?include=svg
请求头：Authorization: Bearer qrs_your_token 和 Content-Type: application/json
请求体：

{
  "target_url": "https://shop.example.com/orders/10492",
  "external_id": "order-10492",
  "name": "Order 10492",
  "folder": "orders"
}

target_url 和 external_id 从触发器里映射过来。ID 可以是订单号、CRM 记录 ID 或活动报名 ID，只要对这条记录来说稳定且唯一就行。

返回结果里，data.short_link 是印刷出来的码所编码的链接，data.svg 是 SVG 文本格式的图片。如果想保存这个码，data.id 就是它的标识。

API 属于 Business 版功能；每个调用的详细说明见 REST API 教程。在「设置」的「API 令牌」里创建令牌，并把它存进自动化工具的凭据或密钥管理里，不要直接写在某个步骤的请求体里。

在 Make 里

添加 HTTP 模块「Make a request」。方法设为 POST，粘贴网址，加上那两个请求头，请求体类型选「Raw」、内容类型选 JSON，再用前一个模块的字段拼出请求体。打开「Parse response」，这样后面的模块就能用 data.short_link。为了不让令牌出现在场景里，用模块的 API key 认证，而不是手写请求头：新建一个钥匙串条目，请求头名称填 Authorization，值填 Bearer qrs_...。根据 HTTP 应用的版本不同，它可能是同一个模块里的认证选项，也可能是一个单独的模块，叫「Make an API Key Auth request」。

在 n8n 里

添加一个 HTTP Request 节点。选 POST 并填网址，Authentication 设为「Generic Credential Type」并选「Header Auth」（名称 Authorization，值 Bearer qrs_...），打开「Send Body」并选 JSON，字段用 {{ $json.order_id }} 这样的表达式。解析后的结果在下一个节点里可以用 {{ $json.data.short_link }} 取到。

在 Zapier 里

使用「Webhooks by Zapier」的「Custom Request」动作，这个动作需要 Zapier 的付费套餐。选 POST，粘贴网址，在 Data 字段里填 JSON 并映射触发器的字段，再加上那两个请求头。后续步骤可以使用返回结果里的 data short_link。

拿到结果后怎么用

放进邮件或消息里发出去。 正文里放短链接，附上或嵌入 SVG。大多数邮件客户端不显示内嵌的 SVG，所以发邮件时，更稳妥的做法是链接到这个码，或者在后续步骤里把 SVG 转成 PNG。
存进文件存储。 把 data.svg 以 order-10492.svg 的文件名写进 Google Drive、Dropbox 或 S3。SVG 印成什么尺寸都清晰。
写回原记录。 把 data.short_link 存回触发工作流的那张订单、那个联系人或那一行，方便以后再找到这个码。

为什么 ID 很重要

自动化会重试。一个触发器可能触发两次，失败的运行也可能被手动重放。如果你用同样的 external_id 和同样的链接再发一次，API 会返回它已经生成的那个码，状态码是 200 而不是 201。如果同一个 ID 带着不同的链接过来，API 回复 409，什么都不改。已经印刷出去的码，永远不会被意外改掉去向。

要改一个码的去向，单独加一个步骤，发送 PATCH https://qrmaker.ai/api/v1/qrcodes/by-external-id/order-10492，请求体是 { "target_url": "..." }。

对扫码做出反应

API 没有 webhook。要在有人扫码时启动工作流，可以用一个定时触发器，每分钟调用一次 GET https://qrmaker.ai/api/v1/scans?since_id=...，保存返回结果里的 next_since_id，下次作为 since_id 传进去。每个事件包含码、你的 external_id、时间、国家和设备。没有新扫码的响应不计入每月额度。

限制

Business 版每月包含 50,000 次成功请求，每分钟最多 120 次。每个订单生成一个码的工作流，每个订单用一次请求。每分钟轮询一次扫码，即使扫码源源不断，每月最多也只用约 43,000 次请求，平时会少得多。

常见问题

有 QR Maker 的 Zapier、Make 或 n8n 应用吗？

没有。每个工具里的通用 HTTP 步骤就能做专用应用能做的一切，而且请求只是一个 POST。

能拿到 PNG 而不是 SVG 吗？

API 只返回 SVG。如果目的地需要 PNG，就在后续步骤里转换，比如用图片转换模块或一小段代码步骤。

如果链接被拒绝了会怎样？

API 会返回一个带有稳定 code 的错误：链接不是有效的 http 或 https 地址时，返回 400 和 INVALID_TARGET_URL；目的地被安全检查拒绝时（比如链接到另一个短网址服务），返回 403 和以 URL_BLOCKED_ 开头的错误码。在错误处理分支里按这个错误码分流，而不是按提示文字。