二维码生成器 API

通过在任何 Linkly 短链接后追加 .qr.png 生成二维码图像。无需身份验证或 API 密钥。

该图像以 PNG 格式返回，并应用所有已保存的二维码样式，包括自定义颜色、点图案、眼睛样式和徽标。

基本用法

在任何 Linkly 短链接后追加 .qr.png：

https://linkly.link/2W6Z9.qr.png

这会返回一个 1024x1024 的二维码 PNG 图像。如果您在 Linkly 中自定义了二维码的颜色、样式或徽标，这些样式会自动应用。

示例

在 HTML 页面中嵌入二维码：

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

或在电子邮件模板、PDF 或任何支持图像 URL 的系统中使用它。

样式参数

传递查询参数以覆盖链接的已保存二维码样式或更改图像大小：

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

注意：十六进制颜色必须进行 URL 编码 — 使用 %23 代替 #（例如 %23ff0000 代表 #ff0000）。

徽标尺寸会自动缩放以匹配请求的图像大小。

quietZone 在整个二维码周围添加空白填充，用 bgColor 填充。这在深色背景上打印二维码时很有用 — 没有它，定位眼睛会紧贴边缘，可能无法可靠扫描。例如，quietZone=50&bgColor=%23ffffff 添加 50 像素的白色边框。

通过链接 API 设置样式

您可以在通过 Link Shortening API 创建或更新链接时将二维码样式保存到链接。传递 qr_styles JSON 对象，包含上面列出的任何样式键：

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

保存后，每当您请求 .qr.png 图像时，这些样式会自动应用 — 无需查询参数。

样式如何应用

二维码样式按以下顺序解析：

1. 1
   默认样式 — 黑色前景，透明背景，方形模块，1024px
2. 2
   已保存样式 — 您在二维码编辑器中所做的任何自定义或通过 Link API 设置的任何内容都与链接一起存储
3. 3
   查询参数覆盖 — 通过 URL 参数覆盖每个请求的各个样式

当存在徽标时，Linkly 会自动使用 高纠错级别 (Level H) 以确保二维码保持可扫描。

速率限制

该端点的速率限制为每个 IP 地址 每秒 5 个请求。图像缓存 5 分钟，因此重复请求相同的二维码会快速提供。

响应

成功的请求返回 200 状态，Content-Type: image/png 和 PNG 图像数据作为响应正文。

错误响应返回 JSON：

{"error": "Rate limit exceeded"}

相关资源

• 创建二维码 - 如何在 Linkly 中创建和自定义二维码
• 向二维码添加徽标 - 使用您的公司徽标创建品牌二维码
• SVG 二维码 - 以可扩展矢量格式下载二维码
• Link Shortening API - 以编程方式创建和管理链接
• Analytics API - 导出点击数据和流量报告