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

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

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

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

基本的な使い方

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

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

これは、QRコードの1024x1024 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モジュールスタイルsquaresdots、またはfluid
eyeStyleアイパターンスタイルsquareまたはrounded
eyeColorInner内側のアイカラー(16進数)%23ff0000
eyeColorOuter外側のアイカラー(16進数)%230000ff
logoImageロゴ画像のURLhttps://example.com/logo.png
logoWidthロゴ幅(ピクセル)60
logoHeightロゴの高さ(ピクセル)60
logoPaddingロゴの周囲のパディング(ピクセル)10
logoStyleロゴパディング形状squareまたはcircle
quietZoneQRコードの周囲のパディング(ピクセル、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. 1
    デフォルトスタイル — 透明な背景上の黒い前景、正方形モジュール、1024px
  2. 2
    保存されたスタイル — QRコードエディタで作成したカスタマイズ、またはリンクAPIを使用して設定したものがリンクとともに保存されます
  3. 3
    クエリパラメータのオーバーライド — URLパラメータを使用して、リクエストごとに個別のスタイルをオーバーライドします

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

レート制限

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

レスポンス

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

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

{"error": "Rate limit exceeded"}

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

QRコード画像を取得するのにAPIキーは必要ですか?

いいえ。短縮リンクURLに.qr.pngを追加するだけです。これはパブリックであり、認証は不要です。

メールやWebページにQRコード画像を埋め込むことができますか?

はい。.qr.png URLは埋め込み用に設計されています。HTMLメール、Webページ、PDF、または画像URLをサポートするシステムで<img>ソースとして使用してください。

カスタムカラーとロゴは含まれていますか?

はい。QRコードは、カスタムカラー、ドット/フルイドパターン、アイスタイル、ロゴなど、保存されているすべてのスタイルでレンダリングされます。クエリパラメータを使用して、任意のスタイルをオーバーライドすることもできます。

生成される画像のサイズはどのくらいですか?

デフォルトサイズは1024x1024ピクセルです。sizeクエリパラメータを使用して、100~2048ピクセルのカスタムサイズを指定できます(例:ABC123.qr.png?size=2048)。

レート制限はありますか?

はい。エンドポイントはIPアドレスごとに1秒あたり5リクエストに制限されています。これを超えた場合、429ステータスコードを受け取ります。

APIを使用してQRコードスタイルを設定できますか?

はい。リンク短縮APIを使用してリンクを作成または更新するときにqr_stylesオブジェクトを渡します。保存されたスタイルは、.qr.png画像をリクエストするときに自動的に適用されます。上記の「リンクAPIを使用してスタイルを設定する」セクションを参照してください。

SVG形式でQRコードを生成できますか?

まだできません。APIは現在PNG形式のみをサポートしています。SVGサポートは将来追加される可能性があります。

関連リソース

対応プラン

Pro以上で利用可能

プランを比較 →

毎月500クリックを無料で追跡できます。