QR コード API クイックスタート

QR Code Genius API を使うと、QR コードをプログラムから生成できます。フルスタイルの PNG 画像、スキャントラッキング付きの一括バッチ、Web ページやメールに直接埋め込める軽量な画像に対応しています。

API キーを作成する

1. サインインして開発者ダッシュボードを開きます。
2. API キーを作成をクリックし、名前を付けます。
3. キーはすぐにコピーしてください。表示されるのは一度だけです。サーバーには安全なハッシュのみが保存されるため、キーを紛失した場合は失効させて再作成する必要があります。

キーは次のような形式です。

qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...

ベース URL

https://www.qrcodegenius.com/api/v1

最初のリクエスト

Authorization ヘッダーにキーを指定し、エンコードしたい内容を POST します。

curl -X POST https://www.qrcodegenius.com/api/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": "https://example.com", "width": 512, "height": 512 }'

レスポンスには、base64 PNG の data URL として QR コードが含まれ、現在の使用状況も返されます。

{
  "success": true,
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}

エンドポイント

• POST /qr — フルスタイルの QR コードを 1 件生成します。QR コードを生成するを参照してください。
• POST /qr/bulk — 1 回の呼び出しで最大 100 件の QR コードを生成してアカウントに保存します。オプションでトラッキング可能な動的コードとしても生成できます（Pro プラン）。QR コードの一括生成を参照してください。
• GET /render — img タグでそのまま使える、高速でキャッシュ可能な PNG です。QR 画像を埋め込むを参照してください。

プランと制限

• Free: 月 50 回の API リクエスト。
• Pro: 月 1,000 回の API リクエストに加え、一括生成が利用可能。
• 購入したクレジットは、月間の割り当てを使い切ると自動的に消費されます。

クォータとエラー処理の詳細はエラーとレート制限を参照してください。