QRコードジェネレーターAPI

Linklyの短縮リンクに.qr.pngを追加してQRコード画像を生成できます。認証やAPIキーは不要です。

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

基本的な使い方

Linklyの短縮リンクに.qr.pngを追加します：

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

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

例

HTMLページにQRコードを埋め込みます：

<img src="https://your-domain.com/ABC123.qr.png" alt="QRコード" />

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

スタイルパラメータ

クエリパラメータを渡して、リンクに保存されたQRスタイルを上書きしたり、画像サイズを変更できます：

https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

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

注：hexカラーはURLエンコードが必要です — #の代わりに%23を使用してください（例：#ff0000は%23ff0000）。

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

リンクAPIでスタイルを設定

リンク短縮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"
  }
}

保存すると、.qr.png画像をリクエストするたびにこれらのスタイルが自動的に適用されます — クエリパラメータは不要です。

スタイルの適用方法

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

1デフォルトスタイル — 透明な背景に黒い前景、正方形モジュール、1024px
2保存済みスタイル — QRコードエディタで行ったカスタマイズやリンクAPIで設定したものがリンクに保存されます
3クエリパラメータによる上書き — URLパラメータでリクエストごとに個別のスタイルを上書き

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

レート制限

エンドポイントはIPアドレスあたり毎秒5リクエストに制限されています。画像は5分間キャッシュされるため、同じQRコードへの繰り返しリクエストは素早く配信されます。

レスポンス

成功したリクエストはContent-Type: image/pngとPNG画像データをレスポンスボディとして200ステータスを返します。

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

{"error": "Rate limit exceeded"}