요금제와 사용량
요금제별 기능, API 호출 집계, 월 사용량 한도
요금제별 기능#
| 항목 | Free | Plus |
|---|---|---|
| API 생성·조회·취소 | 제공 | 제공 |
| 웹훅 | 제공 | 제공 |
| 직접 만든 화면·봇 | 제공 | 제공 |
| 인증 코드 | 한글 4글자 | 한글·영문·숫자 |
| 유효시간 | 60~900초 | 60~900초 |
| 기본 인증 창·QR 설정 | 제공 | 제공 |
| 인증 창 템플릿·브랜딩·워터마크 제거 | 기본 화면 | 제공 |
월 API 호출 한도, 프로젝트 생성 한도, 가격은 요금제와 대시보드 결제 관리에서 확인할 수 있습니다. 프로그램에서 조회할 때는 GET https://api.sendwich.kr/public/v1/plans를 사용합니다.
호출 집계#
월 사용량은 계정에 속한 프로젝트가 공유하며, API 요청 단위로 집계합니다.
| 요청·동작 | 집계 |
|---|---|
| 인증 생성·조회·취소 | 요청마다 1회 |
| 유효한 프로젝트 키로 발생한 오류·재시도 | 요청마다 집계 |
| 같은 Idempotency-Key로 재시도 | 집계 |
| 대시보드 인증 체험 생성 | 집계 |
| 일반 대시보드 조회·설정 변경 | 제외 |
| sendwich 인증 창의 상태 조회 | 제외 |
| 문자 수신·웹훅 전송 | 제외 |
잘못되거나 폐기된 키처럼 계정에 연결할 수 없는 요청은 집계에서 제외합니다.
월 사용량 한도#
한국 시간(Asia/Seoul) 기준 매월 1일 00시에 새 월의 집계를 시작합니다. 한도를 넘으면 429 monthly_call_limit을 반환하며 자동 초과 결제는 발생하지 않습니다. 이미 열린 인증 창과 웹훅 처리는 계속될 수 있습니다.
| 응답 헤더 | 값 |
|---|---|
X-Usage-Calls |
현재 월의 호출 수 |
X-Usage-Limit |
월 한도 또는 unlimited |
요금제를 변경해도 해당 월의 사용량은 유지됩니다.
조회 횟수 관리#
5초 간격으로 5분 동안 조회하면 한 인증에 약 60회의 조회가 발생합니다. 웹훅으로 결과를 저장하거나 사용자가 확인 버튼을 누를 때 조회하면 호출을 줄일 수 있습니다. 주기적인 조회는 최종 상태에 도달하거나 만료 시각이 지나면 중단합니다.