QRコード生成API

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

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

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

Linklyの無料URLショートナーを試す

100個のショートリンクと月間500クリックを無料で取得できます。クレジットカード不要。

月500クリック追跡カスタムドメインクレジットカード不要

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

基本的な使い方

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

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

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

例

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_stylesJSONオブジェクトを渡します：

{
  "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コードがスキャン可能なままであることを確認します。

レート制限

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

レスポンス

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

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

{"error": "Rate limit exceeded"}