QRコードジェネレータAPI

任意のLinklyショートリンクに.qr.pngを追加してQRコード画像を生成します。認証またはAPIキーは不要です。

画像はPNG形式で返され、カスタムカラー、ドットパターン、アイスタイル、ロゴなど、保存されたすべてのQRコードスタイルが適用されます。

Add .qr.png to any Linkly link to get the QR code, served as a PNG

基本的な使い方

任意のLinklyショートリンクに.qr.pngを追加します：

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

これは1024x1024のPNG形式のQRコード画像を返します。LinklyでQRコードの色、スタイル、またはロゴをカスタマイズしている場合、これらのスタイルが自動的に適用されます。

例

HTMLページにQRコードを埋め込む：

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

またはメールテンプレート、PDF、または画像URLをサポートするその他のシステムで使用できます。

スタイルパラメータ

クエリパラメータを渡して、リンクの保存されたQRスタイルをオーバーライドするか、画像サイズを変更します：

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

パラメータ	説明	例
size	画像サイズ（ピクセル、100～2048）	`1024`
fgColor	前景色（16進数、URL エンコード済み）	`%23009eff`
bgColor	背景色（16進数、URL エンコード済み）	`%23ffffff`
qrStyle	モジュールスタイル	`squares`、`dots`、または`fluid`
eyeStyle	アイパターンスタイル	`square`または`rounded`
eyeColorInner	内側のアイ色（16進数）	`%23ff0000`
eyeColorOuter	外側のアイ色（16進数）	`%230000ff`
logoImage	ロゴ画像のURL	`https://example.com/logo.png`
logoWidth	ロゴの幅（ピクセル）	`60`
logoHeight	ロゴの高さ（ピクセル）	`60`
logoPadding	ロゴの周囲のパディング（ピクセル）	`10`
logoStyle	ロゴパディングの形状	`square`または`circle`
quietZone	QRコードの周囲のパディング（ピクセル、0～200）	`50`

注意：16進数の色はURL エンコード済みである必要があります。#の代わりに%23を使用してください（例：#ff0000の場合は%23ff0000）。

ロゴの寸法は、要求された画像サイズに合わせて自動的にスケーリングされます。

quietZoneはQRコード全体の周囲に空白パディングを追加し、bgColorで埋められます。これはQRコードを暗い背景に印刷するときに役立ちます。これがないと、ポジショニングアイがエッジに直接接して、スキャンが信頼できない場合があります。例えば、quietZone=50&bgColor=%23ffffffは50ピクセルの白いボーダーを追加します。

Link APIを使用したスタイルの設定

Link Shortening APIを使用してリンクを作成または更新するときに、QRコードスタイルをリンクに保存できます。上記にリストされたスタイルキーのいずれかを含む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画像をリクエストするたびに自動的に適用されます。クエリパラメータは不要です。

スタイルの適用方法

QRコードスタイルは以下の順序で解決されます：

1
デフォルトスタイル — 透明な背景に黒い前景、正方形のモジュール、1024px
2
保存されたスタイル — QRコードエディタで行ったカスタマイズまたはLink APIを使用して設定したカスタマイズがリンクに保存されます
3
クエリパラメータのオーバーライド — URLパラメータを使用してリクエストごとに個々のスタイルをオーバーライドします

ロゴが存在する場合、Linklyは自動的に**高誤り訂正（レベルH）**を使用して、QRコードがスキャン可能なままであることを確認します。

レート制限

エンドポイントはIPアドレスごとに1秒あたり5リクエストに制限されています。画像は5分間キャッシュされるため、同じQRコードに対する繰り返しリクエストは迅速に提供されます。

レスポンス

リクエストが成功すると、200ステータスとContent-Type: image/pngがPNG画像データとともに返されます。

エラーレスポンスはJSONを返します：

{"error": "Rate limit exceeded"}