二维码生成器 API

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

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

基本用法

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

https://your-domain.com/ABC123.qr.png

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

示例

在 HTML 页面中嵌入二维码：

<img src="https://your-domain.com/ABC123.qr.png" alt="二维码" />

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

样式参数

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

https://your-domain.com/ABC123.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	Logo 图像 URL	`https://example.com/logo.png`
logoWidth	Logo 宽度（像素）	`60`
logoHeight	Logo 高度（像素）	`60`
logoPadding	Logo 周围内边距（像素）	`10`
logoStyle	Logo 内边距形状	`square`、`circle`

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

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

通过链接 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"
  }
}

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

样式的应用方式

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

1默认样式 — 透明背景上的黑色前景、方形模块、1024px
2已保存样式 — 您在二维码编辑器中所做的任何自定义或通过链接 API 设置的样式都会保存在链接中
3查询参数覆盖 — 通过 URL 参数按请求覆盖单个样式

当存在 Logo 时，Linkly 会自动使用**高级纠错（H 级）**以确保二维码仍然可以扫描。

速率限制

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

响应

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

错误响应返回 JSON：

{"error": "Rate limit exceeded"}