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.11 스캔 도달
qr.milestone.1010 스캔 도달
qr.milestone.5050 스캔 도달
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으로 문의하세요.