Zapier APIリファレンス

QR Code MakerのZapier連携の完全なAPIドキュメント。OAuth 2.0認証、全エンドポイント、リクエスト/レスポンス形式、Webhookを含みます。

QR Code MakerをZapierと統合するための完全なAPIリファレンス。このドキュメントは認証、全エンドポイント、リクエスト/レスポンス形式、Webhookイベントをカバーしています。

ベースURL

https://qr-code-maker.app

認証

APIはOAuth 2.0認可コードフローを使用します。

OAuth 2.0フロー

  1. 認可リクエスト - ユーザーを認可ページにリダイレクト
  2. 認可コード - ユーザーが承認、コードを受け取る
  3. トークン交換 - コードをアクセストークンに交換
  4. APIリクエスト - 全リクエストにBearerトークンを使用
  5. トークン更新 - アクセストークン期限切れ時に更新

認可エンドポイント

GET /oauth/authorize

パラメータ：

パラメータ型必須説明
client_idstringはいOAuth クライアントID
redirect_uristringはいリダイレクトURL
response_typestringはいcodeである必要あり
statestringはいCSRF保護用の文字列
scopestringいいえスペース区切りのスコープ

利用可能なスコープ：

スコープ説明
qr_codes:readQRコードの読み取り
qr_codes:write作成、更新、削除
analytics:read統計へのアクセス
webhooks:writeWebhook管理

トークン交換

POST /api/oauth/token

トークン有効期間：

トークン有効期間
認可コード10分
アクセストークン1時間
リフレッシュトークン30日

トークン更新

POST /api/oauth/refresh

APIエンドポイント

全リクエストにBearerトークンが必要です：

Authorization: Bearer qrc_at_xxxxxxxx

接続テスト

GET /api/zapier/me

QRコード一覧

GET /api/zapier/qr

QRコード作成

POST /api/zapier/qr

対応タイプ：

タイプフィールド
website{ "url": "https://..." }
vcard{ "firstName": "", "lastName": "", ... }
wifi{ "ssid": "", "password": "", "security": "WPA" }
email{ "email": "", "subject": "", "body": "" }
sms{ "phone": "", "message": "" }
phone{ "phone": "" }
text{ "text": "" }
event{ "title": "", "startDate": "", "endDate": "", "location": "" }

QRコード取得

GET /api/zapier/qr/{id}

QRコード更新

PATCH /api/zapier/qr/{id}

QRコード削除

DELETE /api/zapier/qr/{id}

検索

GET /api/zapier/qr/search

分析

GET /api/zapier/qr/{id}/analytics

フォルダ

GET /api/zapier/folders

Webhook

登録

POST /api/zapier/webhooks/subscribe

イベント：

イベント説明
qr.scannedQRスキャン
qr.createdQR作成
qr.milestone.100100スキャン達成
qr.milestone.500500スキャン達成
qr.milestone.10001,000スキャン達成
qr.milestone.50005,000スキャン達成
qr.milestone.1000010,000スキャン達成

登録解除

DELETE /api/zapier/webhooks/{id}

エラー処理

HTTPステータスコード

ステータス説明
200成功
201作成完了
204コンテンツなし
400不正なリクエスト
401認証エラー
403アクセス禁止
404見つかりません
422バリデーションエラー
429レート制限超過
500サーバーエラー

レート制限

  • 制限: トークンあたり毎分100リクエスト

はじめに

  1. Zapier連携にアクセス
  2. QR Code Makerを認可
  3. 最初のZapを作成

サポート

ご質問はsupport@qr-code-maker.appまでお問い合わせください。