二维码生成器 API

Name: Linkly
Rating: 4.8 (38 reviews)
Author: Linkly

通过在任何 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 像素的白色边框。

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

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

速率限制

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

响应

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

错误响应返回 JSON：

{"error": "Rate limit exceeded"}