접근 규칙

​

시작하기 전에

• 역할. 규칙 설정, 일시 중지, 재활성화, 삭제에는 워크스페이스 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 코드는 일시 중지되지 않았고, 일정 기간 안에 있으며, 스캔 제한에 도달하지 않았을 때만 목적지로 연결됩니다.

​

자주 발생하는 문제

​

다음 단계