QR 码 API 快速入门

QR Code Genius API 让您以编程方式生成二维码：完整样式的 PNG 图片、带扫描跟踪的批量生成，以及可直接嵌入网页或邮件的轻量图片。

创建 API key

1. 登录并打开开发者控制台。
2. 点击创建 API Key 并为其命名。
3. 立即复制密钥——它只显示一次。我们的服务器只存储安全哈希，因此密钥一旦丢失，必须撤销并重新创建。

密钥的格式如下：

qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...

基础 URL

https://www.qrcodegenius.com/api/v1

第一个请求

在 Authorization 请求头中传入密钥，并通过 POST 提交要编码的内容：

curl -X POST https://www.qrcodegenius.com/api/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": "https://example.com", "width": 512, "height": 512 }'

响应中包含以 base64 PNG data URL 形式返回的二维码，以及您当前的用量：

{
  "success": true,
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}

端点

• POST /qr ——生成单个完整样式的二维码。参见生成二维码。
• POST /qr/bulk ——一次调用最多生成 100 个二维码并保存到您的账户，可选择生成为可跟踪的动态码（Pro 套餐）。参见批量生成二维码。
• GET /render ——快速、可缓存的 PNG，可直接用于 img 标签。参见嵌入二维码图片。

套餐与限制

• Free：每月 50 次 API 请求。
• Pro：每月 1,000 次 API 请求，并可使用批量生成。
• 每月额度用完后，会自动使用已购买的积分。

关于配额和错误处理的详细信息，参见错误与速率限制。