Zapier API 레퍼런스

QR Code Maker Zapier 연동을 위한 완전한 API 문서. OAuth 2.0 인증, 모든 엔드포인트, 요청/응답 형식, 웹훅이 포함됩니다.

QR Code Maker를 Zapier와 통합하기 위한 완전한 API 레퍼런스입니다. 이 문서는 인증, 모든 엔드포인트, 요청/응답 형식, 웹훅 이벤트를 다룹니다.

기본 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:write웹훅 관리

토큰 교환

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

웹훅

구독

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으로 문의하세요.