QRコードAPI
QR Code Crafter APIは、AIエージェント、社内ツール、テンプレート、キャンペーン運用、ドキュメント生成から静的QRファイルを繰り返し作るための公開APIです。
単体生成は /.netlify/functions/generate-qr をGETまたはPOSTで呼び出します。一括生成は /.netlify/functions/generate-qr-bulk にCSVまたはrowオブジェクトを送り、QRファイルとmanifestを含むZIPを受け取ります。
同じリクエスト構造でSVG、PNG、JPG、WebP、PDF、EPSを選べるため、Web掲載、メール、資料、印刷、パッケージ、デザインツールへの受け渡しを一つの流れで扱えます。
AIエージェントは /.well-known/openapi.json、/openapi.yaml、/.well-known/webmcp.json、/ai.txt、/llms.txt からパラメータと例を取得できます。ライブページにはWebMCPツールと宣言型formマークアップもあります。
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
このAPIは静的QR資産を生成します。スキャンダッシュボードや印刷後のリンク先編集が必要な場合は、動的QRまたは自社で管理するリダイレクトを別ワークフローで選び、単純なキャンペーン計測はUTM付きURLを先に作成してからQR化します。
ガイド
単体QR生成エンドポイント
GETクエリまたはPOST JSON bodyで1つのQRファイルを生成できます。長いpayload、vCard、イベント、ロゴdata URLはPOSTの方が安定します。
エージェントが読める発見ファイル
OpenAPI、WebMCP、ai.txt、llms.txtを用意し、ブラウザエージェントやAPIクライアントがリクエストスキーマを推測せずに利用できます。
6種類の出力形式
SVG、PNG、JPG、WebP、PDF、EPSに対応します。印刷やデザイン受け渡しはSVG、PDF、EPS、Webや資料はPNGまたはWebPを優先します。
一括ZIP生成
generate-qr-bulkは最大50行を処理し、QRファイル、manifest.csv、manifest.jsonを含むZIPを返します。
検証できるレスポンスメタデータ
POSTレスポンスとGETヘッダーでcontent type、拡張子、byte length、width、height、unitを確認してから保存できます。
静的・プライバシー重視のモデル
必須の提供元リダイレクトを挟まず、最終payloadをQRパターンに保存します。分析が必要な場合はUTM付きURLを先に作ってからQRにします。
エージェント引き継ぎ用metadata
生成request、response metadata、manifest、ファイル名、形式、担当者、テスト結果を一緒に保存すると、CMS、印刷工程、Google Drive、次のAIエージェントへ安全に渡せます。
QRコードAPIのリクエストオプション
| オプション | 対応値 | 運用時の確認点 |
|---|---|---|
| 単体エンドポイント | GETまたはPOST /.netlify/functions/generate-qr | URL、Wi-Fi、vCard、イベント、決済、テキストなど1つのpayloadをQRファイルにします。 |
| 一括エンドポイント | POST /.netlify/functions/generate-qr-bulk | CSVまたはJSON rowsを送り、ZIP、manifest.csv、manifest.jsonを受け取ります。 |
| 一括上限 | 1リクエスト1-50行 | ブラウザエージェントや公開自動化が過剰なジョブを作らないよう範囲を限定します。 |
| format | svg, png, jpg, webp, pdf, eps | 利用チャネルに合わせて出力を選びます。一括自動化はSVG、印刷受け渡しはPDFまたはEPSが扱いやすくなります。 |
| size | 256-4096 | ラスタ画像と文書出力のサイズを設定します。最終使用サイズより小さい画像を保存しないようにします。 |
| 誤り訂正 | L, M, Q, H | ロゴを入れる場合や印刷条件が厳しい場合はHを選び、最終ファイルを再スキャンします。 |
| レスポンス検証 | contentType, extension, byteLength, width, height, unit | 保存、アップロード、ZIP処理の前に、ファイル形式とサイズがリクエスト意図と一致するか確認します。 |
| 発見ドキュメント | OpenAPI, WebMCP, ai.txt, llms.txt | AIエージェントやクライアントが、現在のエンドポイント、フィールド、例、制限を読めるようにします。 |
| キャンペーン計測 | UTM付きURLまたは自社redirectをエンコード | APIは静的QRを作ります。分析はリンク先側で行います。 |
エージェントがQRコードAPIを呼び出す流れ
APIの流れは小さく保たれています。payloadを作り、形式を選び、レスポンスメタデータを確認してから次のワークフローへ渡します。
自動化ではPOSTを優先する
POST JSONなら長いURL、vCard、イベント、Wi-Fi文字列、決済payload、ロゴdata URLをクエリ文字列に出さず、base64データとファイルメタデータを受け取れます。
直接ダウンロードではGETを使う
GETリクエストはQRファイルを直接返し、X-QR-Width、X-QR-Height、X-QR-Unit、X-QR-Bytesヘッダーでサイズとbyte lengthを提供します。
WebMCPが使える場合はツール登録を利用する
ライブページは対応ブラウザでgenerate_qrとgenerate_bulk_qrツールを登録し、スキャナーが読めるtoolname formも提供します。
保存前にファイルを検証する
contentType、extension、byteLength、dimensionsを確認してから、SVG、PNG、JPG、WebP、PDF、EPSをストレージやCMSに保存します。
一括QR ZIP生成ワークフロー
ラベル、教材、製品パッケージ、メニュー、イベントバッジ、キャンペーン素材など、多数の静的QRファイルが必要な場合にbulk endpointを使います。
CSVまたはrowsオブジェクトを送る
filename,value CSV、またはvalueとfilenameを持つJSONオブジェクトを送ります。空のpayloadや大きすぎる行は生成前に拒否し、downstreamエラーを減らします。
バッチ単位で形式を選ぶ
1つのバッチでは1つのexport formatを使います。大量のエージェント処理ではSVGを優先し、印刷受け渡しではPDFまたはEPSを選びます。
ZIPレスポンスを要求する
Accept: application/zipを送るとbinary ZIPを直接受け取れます。JSONレスポンスではbase64 ZIP、byte length、file count、manifest情報を確認できます。
manifestで結果を照合する
manifest.csvとmanifest.jsonを読み、元の行、生成ファイル名、ステータス、byte countを照合して、失敗した行だけを再処理します。
APIで作成できる静的QR payload
エンドポイントは渡されたpayloadをそのままエンコードします。まずスキャナーが読むべき文字列を正しく作り、その後で必要なファイル形式を生成します。
マーケティングとコンテンツリンク
HTTPS URL、UTM付きキャンペーンリンク、アプリストアページ、ソーシャルプロフィール、メニュー、PDFランディングページ、Googleレビューリンクをエンコードします。
デバイス動作と連絡先
Wi-Fi文字列、mailto、SMS、電話リンク、WhatsAppリンク、カレンダーイベント、地図座標、vCard連絡先payloadを自動生成できます。
決済と地域別payload
PIX EMV、UPI URI、crypto wallet URIなどは、決済情報を先に検証してからQRファイルを生成します。金額と受取人は別の確認手順を置きます。
印刷とデザイン出力
制作 artwork にはSVG、PDF、EPSを使い、素早いWeb掲載やプレビューにはPNG、JPG、WebPを使います。
エージェント引き継ぎと監査記録
APIの価値はQRファイルを返すことだけではありません。生成結果を後続システムが検証し、再生成し、公開停止できる状態で渡せることが重要です。
requestとresponseを保存する
value、contentType、format、size、margin、色、errorCorrectionLevel、ファイル名、contentType、byteLength、width、height、生成日時を資産記録に残します。
manifestを資産台帳へ入れる
bulk ZIPのmanifest.csvとmanifest.jsonを商品、店舗、言語ページ、イベント、包装、PDF、キャンペーン記録と紐づけ、失敗rowだけを再処理できるようにします。
機密payloadを生成前に止める
内部URL、テスト環境、一次利用トークン、非公開ファイル、個人情報、管理画面URLを公開QRに入れないよう、API client側でフィルタリングします。
下げる条件を機械的に追えるようにする
リンク先削除、支払い情報変更、Wi-Fiパスワード更新、プライバシーポリシー変更、印刷物撤去の時に、該当QRファイルを検索して再生成または公開停止できるようにします。
運用安定性とセキュリティ境界
公開APIの自動化は、成功レスポンスを見るだけでは終わりません。速度制限、再試行、payload安全性、ファイル保管、計測方針まで決めておきます。
Retry-Afterとrate-limitを守る
429または503を受け取ったらRetry-AfterとX-RateLimitヘッダーを読み、backoffします。同じリクエストを高速に繰り返すと一括処理の信頼性が下がります。
payloadに秘密情報を入れない
API key、内部トークン、非公開メモ、管理者URL、機微な個人情報はQR payloadに直接入れません。公開されてもよい情報だけをエンコードします。
UTMと自社分析を使う
静的QRは単体でスキャンダッシュボードを作りません。キャンペーン成果が必要な場合は、UTM付きURLや自社管理リダイレクトをpayloadにします。
ライブsmoke testを維持する
本番デプロイ後に代表payloadとSVG、PNG、JPG、WebP、PDF、EPSレスポンスを実際に生成し、content type、サイズ、スキャン可能性を確認します。
QRコードAPI連携チェックリスト
- /ai.txt、/.well-known/openapi.json、/openapi.yaml、/.well-known/webmcp.jsonを先に読み、現在のスキーマと例を確認する。
- vCard、イベント、Wi-Fi、決済、logo data URLなど長いpayloadや特殊文字が多いpayloadはPOST JSONを使う。
- 単体ファイルはgenerate-qr、一括ファイルはgenerate-qr-bulkを使い、batchは50行以下に保つ。
- 一括ダウンロードが必要な場合はAccept: application/zipを送り、manifest.csvとmanifest.jsonを保存する。
- 自動化クライアントには識別できるUser-Agentを設定する。
- 429、503、Retry-After、X-RateLimit-Limit、X-RateLimit-Remainingヘッダーを処理する。
- POSTレスポンスのbase64 dataをデコードし、返されたextensionとcontentTypeに合わせて保存する。
- byteLength、width、height、unit、fileCount、manifest metadataが意図と一致するか検証する。
- URL分析が必要な場合は、QR生成前にUTMパラメータを付ける。
- 秘密トークン、内部管理リンク、機微な個人情報をQR payloadに直接入れない。
- 印刷用ファイルはSVG、PDF、EPSを優先し、最終PDFまたは実物サンプルを再スキャンする。
- 本番利用前に主要content typeと全export formatのライブsmoke testを実行する。
- 生成request、response metadata、manifest、担当者、テスト結果をCMSや資産台帳へ保存する。
- 内部URL、テスト環境、一次利用token、非公開ファイル、個人情報をAPI送信前にブロックする。
- リンク移行、支払い情報変更、Wi-Fi更新、プライバシー変更時に影響するQRファイルを検索できる状態にする。
ガイド: 印刷
静的QRコードを自動生成するQRコードAPI. 静的QRコード. ダウンロード SVG, PNG, JPG, WebP, PDF, EPS. スキャン. QR印刷プリフライトチェックリスト. ライブプレビュー. カスタマイズ QRコード. アカウント不要. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.
静的QRコードを自動生成するQRコードAPI. URL QRコード. ブラウザー内で作成. 印刷. デジタル利用. アクセシビリティ. QRコードの安全性とプライバシー. QRファイル形式. QRコードスキャナー. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.
URL QRコード: HTTPS
静的QRコードを自動生成するQRコードAPI: URL QRコード, ブラウザー内で作成, HTTPS, スキャン. 静的QRコード. 分析向けリンク. UTM. QRコードの安全性とプライバシー.
形式を選択
印刷: SVG, PDF, EPS. デジタル利用: PNG, JPG, WebP, SVG. QRファイル形式. ダウンロード. ベクター書き出し. 形式を選択.
スキャン
スキャン. ライブプレビュー. QRコードスキャナー. QR印刷プリフライトチェックリスト. 印刷. デジタル利用. カスタマイズ. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.
会社
静的QRコードを自動生成するQRコードAPI: URL QRコード, ダウンロード, SVG, PNG, JPG, WebP, PDF, EPS, 印刷, デジタル利用, スキャン. 会社. ガイド. フィードバック.
QRコードAPI
QRコードAPI. OpenAPI. WebMCP. ai.txt. llms.txt. 一括QRワークフロー. ダウンロード SVG, PNG, JPG, WebP, PDF, EPS. 静的QRコード.
静的QRと動的QR
静的QRコードを自動生成するQRコードAPI. 静的QRコード. スキャン制限なし. URL QRコード. 分析向けリンク. QRコードの安全性とプライバシー. ブラウザー内で作成. スキャン.
フィードバック
URL QRコード. 電話QRコード. メールQRコード. アクセシビリティ. スキャン. フィードバック. SMS QRコード.
アクセシビリティ
アクセシビリティ. スキャン. 印刷. デジタル利用. URL QRコード. ブラウザー内で作成. ライブプレビュー.
APIでQRコードを生成する
- 1
単体または一括生成を選ぶ
1つの資産ならgenerate-qrを使い、複数の静的QRファイルをZIPで受け取る場合はgenerate-qr-bulkを使います。
- 2
最終payloadを準備する
URL、Wi-Fi文字列、vCard、イベント、決済URI、テキスト、CSV、rowオブジェクトをスキャナーが読む最終形にします。
- 3
出力形式を選ぶ
印刷とデザインにはSVG、PDF、EPSを、Web掲載と資料プレビューにはPNG、JPG、WebPを選びます。
- 4
レスポンスを検証する
success、content type、extension、byte length、dimensions、manifestを確認してから保存または次のシステムに渡します。
- 5
再試行と監視を入れる
Rate-limitヘッダーとRetry-Afterを処理し、失敗rowと生成ファイル数をログに残して、自動化が静かに失敗しないようにします。
よくある質問
QR Code Crafter APIのエンドポイントは何ですか？
単体QRは /.netlify/functions/generate-qr をGETまたはPOSTで呼び出します。最大50ファイルのZIPが必要な場合は /.netlify/functions/generate-qr-bulk にPOST JSONまたはCSV rowsを送ります。
APIでQRコードを一括生成できますか？
はい。generate-qr-bulkはCSVまたはrowオブジェクトを受け取りZIPを生成します。ZIPにはQRファイルとmanifest.csv、manifest.jsonが含まれます。
これはQR code generator APIですか？
はい。静的ファイル向けのQR code generator APIです。payloadを送るとSVG、PNG、JPG、WebP、PDF、EPSのQRコードを生成できます。API QR code generator、qrcode API、QR API、generate QR code APIを探しているチームは同じ公開endpointを使えます。
QRコードAPIは無料で使えますか？
公開生成はアカウントなしで使えます。発行されたキーがある環境ではX-Agent-Api-Keyを含められます。クライアントは401レスポンスも処理してください。
APIはどのファイル形式を返しますか？
SVG、PNG、JPG、WebP、PDF、EPSに対応します。自動化や大量処理にはSVGが軽く、印刷受け渡しにはPDFまたはEPSが適しています。
ブラウザエージェントはWebMCPでQRコードを作れますか？
対応ブラウザでは、ライブページがgenerate_qrとgenerate_bulk_qrツールを登録します。toolname属性を持つ宣言型formマークアップも提供します。
APIは動的な追跡QRコードを作りますか？
いいえ。このAPIは静的QR資産を作ります。キャンペーン計測が必要な場合は、UTM付きURLや自社管理リダイレクトURLを先に作ってからQR化します。
一括自動化でrate limitはどう扱いますか？
429または503が返ったらRetry-AfterとX-RateLimitヘッダーを読み、backoffします。同じpayloadを即時に繰り返さず、失敗rowだけを再処理してください。
エージェントは生成されたQRファイルをどう検証しますか？
contentType、extension、byteLength、width、height、unitを確認し、一括ZIPではmanifestのファイル数と状態を元rowと比較します。
QR payloadに入れてはいけない情報はありますか？
API key、アクセストークン、内部管理URL、非公開メモ、機微な個人情報を公開QR payloadに直接入れないでください。QRはスキャン可能な公開資産として扱います。
本番導入前に必要なテストは？
代表payloadと全export formatを本番エンドポイントで実際に生成し、ファイル形式、サイズ、manifest、スキャン可能性を確認するライブsmoke testが必要です。
AIエージェントが生成したQRファイルはどう引き継ぐべきですか？
ファイルだけでなく、生成request、response metadata、manifest、対象URL、担当者、テスト端末、スキャン結果を一緒に保存します。後で再生成、監査、削除、差し替えが必要になった時に追跡できます。
API送信前にブロックすべきpayloadはありますか？
内部URL、テスト環境、一次利用トークン、非公開ファイル、管理画面URL、個人情報は公開QRにしないでください。自動化client側で公開可能なpayloadだけをAPIへ送る必要があります。