二维码 API生成器

二维码 API: OpenAPI, WebMCP, ai.txt. generate_qr, generate_bulk_qr. 下载 SVG, PNG, JPG, WebP, PDF, EPS. 静态二维码.

二维码 API

QRCode Crafter 的二维码 API 面向自动化工具、AI 代理、批量生成脚本和内部运营系统。单个二维码使用 /.netlify/functions/generate-qr，可通过 GET 查询参数或 POST JSON 请求生成。

批量任务使用 /.netlify/functions/generate-qr-bulk，通过 CSV 或 JSON 一次提交最多 50 个二维码，并返回 ZIP、manifest.csv、manifest.json 和每个文件的状态信息。

API 支持 SVG、PNG、JPG、WebP、PDF、EPS 六种导出格式，适合网页、邮件、文档、设计源文件、印刷校样和供应商交付。

这是静态二维码工作流：内容会写入二维码图案，下载后的文件不依赖账号、订阅或扫码额度。需要活动统计时，应在 URL 中加入 UTM 参数，再用第一方网站分析工具查看访问。

面向 AI 代理时，可以通过 OpenAPI、WebMCP、ai.txt、llms.txt 和页面中的 toolname 表单发现 generate_qr 与 generate_bulk_qr 工具，减少猜测参数的成本。

OpenAPI GenerateQrRequest 包含 x-agent-recipes，WebMCP 包含 api.agentRecipes。支持的支付和支付链接内容包括 PhonePe-compatible UPI、Swiss QR-bill、SEPA/GiroCode、iDEAL、MobilePay/Vipps 和 QRIS。

上线前请把响应头、文件大小、二维码尺寸、内容类型、错误处理、速率限制和最终扫码测试纳入自动化验收，而不是只检查 HTTP 200。

如果二维码会进入 CMS、Google Drive、印刷供应商、邮件系统或另一个代理工作流，请把生成请求、响应 metadata、manifest、目标 URL、负责人和测试结果一起保存。这样后续可以审计、重新生成或下线，而不是只留下无法追溯的图片文件。

代理自动生成二维码时，还应区分公开 payload 与敏感 payload。公开海报、包装、菜单和付款物料只应编码用户本来可以看到的信息；内部测试地址、一次性授权链接、未公开文件和个人信息应在提交 API 前被拦截。

指南

单个生成：GET 或 POST

generate-qr 适合 URL、Wi-Fi、vCard、活动、位置、短信、邮件、电话、WhatsApp、支付和文本二维码。GET 便于快速测试，POST JSON 更适合结构化负载和自动化。

批量生成：CSV 或 JSON

generate-qr-bulk 适合门店、商品、活动、课程、房源和多语言页面批量生成。返回 ZIP 与清单文件，便于代理或脚本确认每个二维码是否成功。

AI 代理可发现

OpenAPI、WebMCP、ai.txt、llms.txt 和 toolname 表单描述参数、格式、示例和端点，帮助代理直接调用生成工具而不是解析页面界面。

六种导出格式

SVG、PDF、EPS 适合印刷和设计交付，PNG、JPG、WebP 适合网页、文档、邮件和快速数字分享。高频任务优先考虑轻量 SVG。

静态、无账号、无扫码额度

二维码文件下载后不需要 QRCode Crafter 账号继续工作，也不会因平台扫码额度耗尽而停止。目标内容和文件质量仍由你的系统负责。

可验证的响应元数据

响应可包含内容类型、扩展名、字节数、宽高和批量清单。自动化流程应校验这些字段，并对失败项重试或记录。

可接入隐私友好的统计

API 不需要动态跳转层来记录扫码。需要归因时，可在 URL 负载中加入 UTM，并在自有分析工具中处理访问数据。

适合代理交接的 metadata

单个响应和批量 manifest 可记录文件名、格式、尺寸、字节数、状态和失败原因，方便 CMS、资产库、印刷流程或后续 AI 代理继续处理。

生成前过滤敏感 payload

自动化流程应在调用 API 前识别内网地址、一次性令牌、未公开文件、测试环境和个人敏感信息，避免把不应公开的内容写入永久二维码。

二维码 API 请求方式对比

判断项单个二维码 API批量二维码 API
端点GET 或 POST /.netlify/functions/generate-qr，适合一次生成一个二维码。POST /.netlify/functions/generate-qr-bulk，适合一次提交 CSV 或 JSON 批量任务。
输入数据value、format、size、margin、颜色、纠错等级、logo、contentType 等参数。文件名、负载值、格式和共享样式设置；一次最多 50 个二维码，便于控制吞吐和错误恢复。
输出返回 SVG、PNG、JPG、WebP、PDF 或 EPS 文件，以及可检查的内容类型和尺寸信息。返回 ZIP，包含二维码文件、manifest.csv、manifest.json 和每个项目的状态。
适用场景AI 代理即时生成、表单提交、单个活动链接、即时预览或低频自动化。门店、产品、课程、活动、房源、多语言页面和定期内容清单批量生成。
发现方式OpenAPI、WebMCP、ai.txt、llms.txt 和页面表单可说明 generate_qr 参数。OpenAPI 与 WebMCP 描述 generate_bulk_qr 的 JSON、CSV、ZIP 和清单响应。
错误处理检查状态码、Retry-After、X-RateLimit 头、内容类型、文件大小和扫码结果。检查批量清单中的每个项目，失败项单独重试，避免整批任务重复生成。
文件格式高频自动化优先使用 SVG；需要位图或印刷交付时再选择 PNG、PDF、EPS 等。批量任务应统一格式、尺寸、命名规则和测试记录，避免团队混用低清文件。
统计与隐私静态 URL 可带 UTM，用第一方分析查看访问，不必强制经过二维码供应商跳转。批量生成时应统一 UTM 命名、隐私说明和目标页面所有权。
代理交接保存请求参数、响应 metadata、文件名、测试结果和负责人，方便后续重新生成。读取 manifest.csv 和 manifest.json，把每个文件状态、失败原因和重试动作写回资产记录。
安全过滤提交前拦截内网地址、一次性授权链接、未公开文件和敏感个人信息。批量任务先抽样检查 payload，再允许进入 ZIP、邮件、印刷或公开 CMS 流程。

代理和自动化工作流

AI 代理、内部脚本和工作流工具应先读取可发现的接口说明，再提交参数。这样可以稳定生成二维码，而不需要模拟人工点击页面。

OpenAPI 作为机器可读合同

使用 /.well-known/openapi.json 或 /openapi.yaml 获取参数、格式、示例、响应头和错误状态。代理可以据此选择 generate-qr 或 generate-qr-bulk。

WebMCP 作为浏览器上下文

WebMCP manifest 和页面 toolname 表单描述 generate_qr、generate_bulk_qr、contentType、format、size、margin、颜色和纠错等级。

ai.txt 与 llms.txt 给出爬取和调用提示

这些文件说明站点提供什么工具、哪些内容适合 AI 输入、如何调用 API，以及何时使用 Markdown 响应减少 token。

不要依赖视觉界面猜参数

代理应使用已声明的 schema、表单字段和示例请求，避免从按钮文字或截图中推断 payload、格式和错误处理。

单个二维码生成

generate-qr 适合即时生成一个二维码。GET 便于调试，POST JSON 更适合结构化内容、Logo、复杂支付负载和代理调用。

URL、文本和联系方式

可生成 URL、文本、电子邮件、短信、电话、WhatsApp、vCard、活动和位置二维码，并下载为 SVG、PNG、JPG、WebP、PDF 或 EPS。

Wi-Fi、活动和位置内容

结构化字段应在提交前验证，尤其是 SSID、安全类型、日历时间、经纬度和用户可读说明。

支付和地区负载

PIX、UPI、PhonePe-compatible UPI、Swish、SEPA/GiroCode、PromptPay、VietQR、Swiss QR-bill、iDEAL、MobilePay/Vipps、QRIS、PayPal、Venmo、Cash App 和加密货币内容应在生成后用真实扫码流程确认。

Logo 与样式

Logo data URL 应控制大小和格式，保持高纠错等级、足够留白和强对比。生成后必须扫描最终文件，而不只看预览。

批量二维码 ZIP 工作流

批量端点用于一次生成多个静态二维码，适合产品目录、门店页面、课程资料、活动链接、房源、批量 UTM 活动和多语言页面。

CSV 或 JSON 输入

最少准备 filename 与 value，也可以统一传入 format、size、margin、颜色、contentType 和纠错等级。批量限制有助于控制资源和失败恢复。

ZIP 与清单文件

请求 Accept: application/zip 可得到二维码文件包。manifest.csv 和 manifest.json 应记录文件名、状态、字节数、格式和失败原因。

失败项单独重试

不要在少数项目失败时重跑整批任务。读取 manifest，提取失败项，按 Retry-After 和速率限制进行重试。

命名和归档

文件名应体现门店、商品、语言、活动或地区，并与目标 URL、UTM、负责人、测试日期一起保存。

响应校验和错误处理

可靠的 API 集成必须验证响应内容，而不只是判断请求是否返回 200。

检查内容类型和扩展名

确认 contentType、扩展名和请求格式一致。SVG 应是可解析 XML，位图应能打开，PDF/EPS 应能被下游工具处理。

检查尺寸和字节数

记录 X-QR-Width、X-QR-Height、X-QR-Bytes 或清单中的 byteLength，避免空文件、过小文件或错误 HTML 被保存为二维码。

处理 401、429 和 503

如果启用 X-Agent-Api-Key，应处理 401。遇到 429 或 503 时读取 Retry-After 和 X-RateLimit 头，使用退避重试。

扫码验证

对每种内容类型和文件格式保留抽样扫码测试，特别是 Logo、支付、Wi-Fi、PDF/EPS 和批量 ZIP 输出。

代理交接、资产库和审计记录

二维码 API 的竞争力不只在于能生成文件，还在于生成结果能被代理、CMS、设计系统、印刷团队和搜索工作流可靠接收。

保存请求和响应证据

记录 value、contentType、format、size、margin、颜色、纠错等级、文件名、contentType、byteLength、width、height 和生成时间，方便以后复查同一个二维码是否可以重新生成。

把 manifest 写入资产库

批量 ZIP 的 manifest.csv 和 manifest.json 应与商品、门店、语言页面、课程、活动或包装记录关联，避免团队只保存一个无法追溯的下载包。

为下游系统选择格式

CMS 和邮件系统通常需要 PNG、JPG 或 WebP；设计和印刷流程应保留 SVG、PDF 或 EPS 主文件；代理应根据目标系统选择格式而不是固定使用截图。

建立失败和下线流程

当目标页面删除、付款信息变化、Wi-Fi 密码轮换或隐私说明更新时，自动化应能找到受影响文件、重新生成二维码或从公开页面移除旧二维码。

适合静态 API 的内容类型

静态二维码适合目标内容明确、可公开、能长期维护的工作流。需要后期改目标时，应优先使用自有重定向或明确的动态 QR 产品。

URL 与 UTM

将自有 HTTPS URL 和 UTM 参数编码进静态二维码，用第一方分析平台查看访问来源、媒介和活动。

Wi-Fi、vCard 和活动

这些负载通常就是最终动作，适合直接编码为静态二维码并导出到海报、名片、票据或现场说明。

支付和地区二维码

付款二维码应显示收款方、金额、币种或用途说明，并在正式发布前使用对应支付 App 验证。

设计和印刷交付

同一 API 负载可导出为 SVG、PDF、EPS、PNG、JPG 或 WebP，但最终文件应按渠道重新测试。

二维码 API 集成检查清单

  • 先读取 OpenAPI、WebMCP、ai.txt 和 llms.txt，确认端点、参数、格式、速率限制和错误模型。
  • 单个二维码使用 generate-qr；结构化负载、Logo 和复杂内容优先使用 POST JSON。
  • 批量二维码使用 generate-qr-bulk，并为 CSV 或 JSON 输入准备稳定文件名、目标值、格式和共享样式。
  • 高频生成优先选择 SVG；需要位图、PDF、EPS 或 Logo 时降低并发并处理 Retry-After。
  • 检查返回的 contentType、extension、byteLength、width、height、fileCount 和 manifest 项状态。
  • 对 401、429、503、格式错误、负载过长、Logo 过大和批量部分失败建立明确重试策略。
  • URL 负载需要统计时先加入 UTM，并用自有分析工具衡量访问，不依赖二维码供应商扫码统计。
  • 不要把内网地址、一次性令牌、未公开文件或敏感个人信息编码进公开二维码。
  • 每种内容类型至少测试 SVG、PNG、PDF 三类代表格式；正式场景再覆盖 JPG、WebP、EPS。
  • 批量 ZIP 下载后读取 manifest.csv 和 manifest.json，失败项单独重试，不要盲目重跑整批。
  • 保存目标内容、文件名、负责人、导出格式、测试结果和发布日期，便于审计和重新生成。
  • 上线前让 AI 代理按同一 schema 生成所有需要的内容类型和格式，并验证扫码结果。
  • 把生成请求、响应 metadata、manifest、目标页面状态码和最终扫码结果保存到资产记录中。
  • 提交 API 前过滤内网地址、测试环境、一次性授权链接、未公开文件和个人敏感信息。
  • 为 CMS、邮件、设计、印刷和代理交接分别选择合适格式，不要把截图当作生产文件。
  • 目标页面迁移、付款信息变化、Wi-Fi 密码轮换或隐私政策更新时，重新检查受影响二维码。

指南: 印刷

二维码 API生成器. 静态二维码. 下载 SVG, PNG, JPG, WebP, PDF, EPS. 扫码. 二维码印前检查清单. 实时预览. 自定义 二维码. 无需账户. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.

二维码 API生成器. URL 二维码. 在浏览器中创建. 印刷. 数字使用. 无障碍. 二维码安全与隐私. 二维码文件格式. 二维码扫描器. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.

URL 二维码: HTTPS

二维码 API生成器: URL 二维码, 在浏览器中创建, HTTPS, 扫码. 静态二维码. 适合分析的链接. UTM. 二维码安全与隐私.

选择格式

印刷: SVG, PDF, EPS. 数字使用: PNG, JPG, WebP, SVG. 二维码文件格式. 下载. 矢量导出. 选择格式.

扫码

扫码. 实时预览. 二维码扫描器. 二维码印前检查清单. 印刷. 数字使用. 自定义. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.

公司

二维码 API生成器: URL 二维码, 下载, SVG, PNG, JPG, WebP, PDF, EPS, 印刷, 数字使用, 扫码. 公司. 指南. 反馈.

二维码 API

二维码 API. OpenAPI. WebMCP. ai.txt. llms.txt. 批量二维码流程. 下载 SVG, PNG, JPG, WebP, PDF, EPS. 静态二维码.

静态与动态二维码

二维码 API生成器. 静态二维码. 无扫码限制. URL 二维码. 适合分析的链接. 二维码安全与隐私. 在浏览器中创建. 扫码.

反馈

URL 二维码. 电话二维码. 邮件二维码. 无障碍. 扫码. 反馈. 短信二维码.

无障碍

无障碍. 扫码. 印刷. 数字使用. URL 二维码. 在浏览器中创建. 实时预览.

五步接入二维码 API

  1. 1

    读取 schema 和示例

    从 OpenAPI、WebMCP、ai.txt 和 llms.txt 获取端点、字段、格式、限制和示例请求，确认代理不需要猜测参数。

  2. 2

    选择单个或批量端点

    一次生成一个二维码时使用 generate-qr；列表、门店、商品、多语言页面或活动清单使用 generate-qr-bulk。

  3. 3

    确定内容类型和格式

    根据目标选择 URL、Wi-Fi、vCard、活动、位置、支付或文本内容，再按渠道选择 SVG、PNG、JPG、WebP、PDF 或 EPS。

  4. 4

    校验响应和错误

    检查内容类型、扩展名、字节数、尺寸、清单状态、Retry-After 和失败原因，并把失败项记录到重试队列。

  5. 5

    扫码并归档

    抽样扫描最终文件，保存目标内容、UTM、负责人、导出格式、测试日期和结果，保证后续可复查和重新生成。

  6. 6

    交接并复查

    把二维码文件、manifest、请求参数、目标页面质量检查和下线条件交给 CMS、设计、印刷或运营团队，并为长期公开二维码设置复查日期。

常见问题

二维码 API 的单个生成端点是什么？

单个二维码使用 /.netlify/functions/generate-qr。可以用 GET 查询参数快速测试，也可以用 POST JSON 提交结构化内容、Logo、颜色、尺寸和导出格式。

如何批量生成二维码？

使用 /.netlify/functions/generate-qr-bulk 提交 CSV 或 JSON，一次最多 50 个二维码。请求 ZIP 响应时会得到文件包、manifest.csv 和 manifest.json。

API 是否需要账号或密钥？

静态生成默认不要求账号。某些代理或高频集成可能使用 X-Agent-Api-Key；如果启用校验，客户端应正确处理 401。

API 支持哪些二维码文件格式？

支持 SVG、PNG、JPG、WebP、PDF 和 EPS。高频自动化优先使用 SVG；印刷和供应商交付通常选择 SVG、PDF 或 EPS。

AI 代理如何发现二维码工具？

代理可以读取 OpenAPI、WebMCP manifest、ai.txt、llms.txt 和页面中的 toolname 表单，找到 generate_qr 与 generate_bulk_qr 的参数和示例。

静态二维码 API 能做统计吗？

静态二维码本身不记录扫码。需要活动归因时，在 URL 中加入 UTM 参数，并在自有网站分析工具中查看访问。

集成时应处理哪些错误？

至少处理 400 参数错误、401 密钥错误、413 负载过大、429 速率限制和 503 暂时不可用。遇到 Retry-After 应退避重试。

批量 ZIP 中的 manifest 有什么作用？

manifest.csv 和 manifest.json 用于核对每个文件的状态、字节数、格式和失败原因。自动化流程应读取清单，而不是只检查 ZIP 是否下载成功。

API 可以生成哪些二维码内容？

可以生成 URL、文本、Wi-Fi、邮件、短信、电话、WhatsApp、vCard、活动、位置、加密货币和多种地区支付二维码。上线前请对每类内容做扫码测试。

使用二维码 API 时有哪些安全注意事项？

不要把内网地址、访问令牌、一次性授权链接、未公开文件或敏感个人信息放入公开二维码。应使用 HTTPS、可维护的公开页面和清晰的用户说明。

AI 代理生成二维码后应该保存哪些记录？

建议保存请求参数、响应 metadata、文件名、manifest、目标 URL、负责人、导出格式、测试设备、扫码结果和复查日期。这样后续代理或运营团队可以审计、重新生成或下线。

API 自动化应该默认使用哪种格式？

高频代理和批量任务通常优先 SVG；CMS、邮件和文档可以用 PNG 或 WebP；印刷、设计和供应商交付应保留 SVG、PDF 或 EPS 主文件，并扫描最终交付版本。

这是 QR code generator API 吗？

是。它是用于静态文件的 QR code generator API：提交 payload 后可生成 SVG、PNG、JPG、WebP、PDF 或 EPS。搜索 API QR code generator、qrcode API、QR API 或 generate QR code API 的团队可使用同一个公开端点。