開発者向け

QRコードAPI

自分のコードから直接QRコードを生成し、スキャン分析を読み取れます。CodesQR APIは、JSONを返す小さく予測可能なRESTインターフェースで、すべてのCodesQRアカウントで利用できます。

認証

すべてのリクエストは、ベアラートークンとして送信される秘密のAPIキーで認証されます。ダッシュボードの「設定」からキーを作成し、サーバー側に保管して、クライアントコードで公開しないでください。すべてのリクエストはHTTPSでhttps://api.codesqr.comに送られます。

Authorization: Bearer sk_live_your_api_key

エンドポイント

POST /v1/qr

スタティックまたはダイナミックQRコードを作成します。

GET /v1/qr/{id}

単一のQRコードとその画像URLを取得します。

PATCH /v1/qr/{id}

ダイナミックコードのリンク先やタイトルを変更します。

GET /v1/qr/{id}/stats

ダイナミックコードのスキャン分析を読み取ります。

GET /v1/qr

アカウント内のQRコードを一覧します。

DELETE /v1/qr/{id}

QRコードを削除します。

QRコードを作成

POSTを/v1/qrにタイプとターゲットとともに送信します。dynamic: trueを設定すると、後から更新できる編集可能で追跡可能なコードが得られます。レスポンスには、すぐに使えるPNGとSVGの画像URLが含まれます。

リクエスト

curl https://api.codesqr.com/v1/qr \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "target": "https://example.com/spring-sale",
    "dynamic": true,
    "title": "Spring Sale Poster",
    "color": { "dark": "#059669", "light": "#ffffff" },
    "format": "png"
  }'

レスポンス

{
  "id": "qr_8fK2p1Qz",
  "type": "url",
  "target": "https://example.com/spring-sale",
  "dynamic": true,
  "short_url": "https://csqr.io/8fK2p1Qz",
  "image_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.png",
  "svg_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.svg",
  "scans": 0,
  "created_at": "2026-07-18T10:24:00Z"
}

ダイナミックコードを更新

ダイナミックQRコードは印刷したパターンを同じに保つため、PATCHでいつでも新しい場所に向けられます。既存の印刷済みコードは機能し続け、再印刷は不要です。

リクエスト

curl -X PATCH https://api.codesqr.com/v1/qr/qr_8fK2p1Qz \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "target": "https://example.com/summer-sale" }'

スキャン統計を読み取る

ダイナミックコードについては、GETを/v1/qr/{id}/statsに送ってスキャン分析を取得します。合計、日ごとの内訳、グラフ化やエクスポートができるデバイス構成が得られます。

リクエスト

curl https://api.codesqr.com/v1/qr/qr_8fK2p1Qz/stats \
  -H "Authorization: Bearer sk_live_your_api_key"

レスポンス

{
  "id": "qr_8fK2p1Qz",
  "total_scans": 1842,
  "unique_scans": 1310,
  "range": "last_30_days",
  "by_day": [
    { "date": "2026-07-16", "scans": 74 },
    { "date": "2026-07-17", "scans": 91 },
    { "date": "2026-07-18", "scans": 63 }
  ],
  "by_device": { "mobile": 1521, "desktop": 248, "tablet": 73 }
}

レート制限とエラー

APIは標準のHTTPステータスコードを返します: 成功時は200、不正なリクエストには400、不正なキーには401、プランのレート制限を超えたときは429。エラーレスポンスには、機械可読なcodeと人間が読めるmessageが含まれます。コードをまったく書きたくないですか?アプリ内ですべてを手動で作成・管理できます。まずはすべてのQRコードの種類を探すのもよいでしょう。

作り始める準備はできましたか?

無料のCodesQRアカウントを作成し、「設定」でAPIキーを生成して、1回のリクエストで最初のQRコードを作りましょう。

無料アカウントを作成

追跡可能なQRコードは1分で作れます

コードをあらゆるリンクやファイルに向け、すべてのスキャンを追跡し、必要なときにいつでもリンク先を変更できます。

無料QRコードを作成

永久に無料
クレジットカード不要
数分でセットアップ