アクセスルール

​

始める前に

• 役割。 ルールの設定、一時停止、再開、削除には、ワークスペースの QR コードへの書き込み権限が必要です。認証 をご覧ください。
• サブスクリプション。 これらを含むすべての API リクエストには、ワークスペースのオーナーの有効なサブスクリプションが必要です。

​

access オブジェクト

POST  /api/v1/qrs
PATCH /api/v1/qrs/{qrId}

​

開始と終了を予約する

curl -X PATCH "https://getqr.com/api/v1/qrs/qr_abc123" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "access": {
      "activeAt": "2026-08-01T09:00:00Z",
      "pauseAt": "2026-08-31T23:59:59Z"
    }
  }'

{
  "access": { "activeAt": null, "pauseAt": null }
}

​

スキャン上限

{
  "access": { "scanLimit": 500 }
}

• 上限を引き上げる と、ちょうど（新しい上限 − 総スキャン数）回分のスキャンが追加で可能になります。
• 上限を引き下げて 現在の合計を下回ると、QR コードはすぐにブロックされます。
• 後から上限を設定する と、上限がなかった間のスキャンもカウントされます。

​

パスワード保護

{ "access": { "password": "hunter2" } }

{ "access": { "passwordProtected": false } }

{ "access": { "passwordProtected": true } }

• 作成時。 保護を有効にするには password を送ります。パスワードが存在するまでは、passwordProtected だけを送っても効果はありません。
• パスワードの削除。 "password": null を送ります。保護もオフになります。
• 読み取り。 レスポンスがパスワードを返すことはなく、access.passwordProtected だけが返ります。

​

一時停止と再開と削除

curl -X POST "https://getqr.com/api/v1/qrs/qr_abc123/pause" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_abc123",
  "archived": true,
  "…": "…"
}

{ "id": "qr_abc123", "deleted": true }

​

変更が反映されるタイミング

• 次のスキャンから。 ルールはコードがスキャンされたときに確認されるため、変更は次のスキャンから適用され、さかのぼって適用されることはありません。
• 停止ページ。 スケジュール、スキャン上限、一時停止によってブロックされた QR コードは、停止ページを表示します。スキャンはリダイレクトされません。
• パスワード。 すでにパスワードを入力した訪問者は、パスワードが変更されるか、保護がオフにされて再びオンにされるまで、アクセスを維持します。
• 時計。 スケジュールは、訪問者の現地時刻ではなく、UTC のサーバー時刻を使います。
• ルールの組み合わせ。 QR コードがリンク先に進むのは、一時停止中でなく、スケジュールの期間内で、スキャン上限に達していない場合だけです。

​

よくある問題

​

次のステップ