二维码生成器 API

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

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

在任何 Linkly 链接后添加 .qr.png 以获取二维码，以 PNG 格式提供

基本用法

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

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

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

示例

在 HTML 页面中嵌入二维码：

<img src="https://linkly.link/2W6Z9.qr.png" alt="二维码" />

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

样式参数

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

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

参数	描述	示例
size	图像尺寸（像素，100–2048）	`1024`
fgColor	前景色（十六进制，URL 编码）	`%23009eff`
bgColor	背景色（十六进制，URL 编码）	`%23ffffff`
qrStyle	模块样式	`squares`、`dots` 或 `fluid`
eyeStyle	眼睛图案样式	`square` 或 `rounded`
eyeColorInner	内眼颜色（十六进制）	`%23ff0000`
eyeColorOuter	外眼颜色（十六进制）	`%230000ff`
logoImage	徽标图像的 URL	`https://example.com/logo.png`
logoWidth	徽标宽度（像素）	`60`
logoHeight	徽标高度（像素）	`60`
logoPadding	徽标周围的填充（像素）	`10`
logoStyle	徽标填充形状	`square` 或 `circle`
quietZone	二维码周围的填充（像素，0–200）	`50`

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

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

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

通过链接 API 设置样式

您可以在通过链接缩短 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默认样式 — 透明背景上的黑色前景，方形模块，1024px
2已保存的样式 — 您在二维码编辑器中所做的任何自定义或通过链接 API 设置的内容都与链接一起存储
3查询参数覆盖 — 通过 URL 参数覆盖每个请求的单个样式

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

速率限制

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

响应

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

错误响应返回 JSON：

{"error": "速率限制已超出"}