QRコード生成API

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

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

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

Linklyリンクに .qr.png を追加してQRコードをPNGとして取得

基本的な使い方

任意のLinkly短縮リンクに .qr.png を付加します:

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

これにより1024x1024のQRコードPNG画像が返されます。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ピクセルの白色の枠線を追加します。

リンク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",
    "quietZone": 50
  }
}

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

スタイルの適用方法

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

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

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

レート制限

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

レスポンス

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

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

{"error": "Rate limit exceeded"}