二维码生成器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默认样式 — 透明背景上的黑色前景，方形模块，1024像素
- 2保存的样式 — 您在二维码编辑器中进行的任何自定义或通过链接API设置的样式都与链接一起存储
- 3查询参数覆盖 — 通过URL参数按请求覆盖各个样式
当存在徽标时，Linkly自动使用**高纠错级别(Level H)**以确保二维码保持可扫描性。
速率限制
该端点的速率限制为每个IP地址每秒5个请求。图像缓存5分钟，因此重复请求同一二维码会快速返回。
响应
成功请求返回200状态，Content-Type: image/png以及PNG图像数据作为响应体。
错误响应返回JSON：
{"error": "速率限制已超出"}
每月追踪500次点击，包含所有功能。