# sendwich 시작하기

> SMS 인증 흐름과 인증 창·API 연동 방식

문서: https://sendwich.kr/docs/

## 인증 흐름

sendwich는 사용자가 보낸 SMS의 발신 번호로 휴대폰 번호를 확인합니다.

1. 서비스 서버에서 인증을 생성합니다.
2. 사용자에게 받는 번호와 인증 문자를 표시합니다.
3. 사용자가 자신의 휴대폰에서 문자를 전송합니다.
4. API 조회 또는 웹훅으로 인증 결과를 받습니다.

확인 범위는 휴대폰 번호의 점유입니다. 실명·생년월일·CI·DI를 제공하는 본인확인 서비스는 아닙니다.

## 연동 방식

| 방식 | 인증 화면 | 설정 |
| --- | --- | --- |
| [sendwich 인증 창](https://sendwich.kr/docs/verification-window/) | 제공되는 팝업·모바일 화면 | API 키, 팝업·복귀 주소(사용 시) |
| [API 직접 연동](https://sendwich.kr/docs/api/) | 서비스의 웹·앱·봇에서 구현 | 서버용 API 키 |

두 방식 모두 Free와 Plus에서 사용할 수 있으며, 같은 프로젝트에서 함께 운영할 수 있습니다. 결과 수신에는 API 조회와 웹훅을 지원합니다.

[첫 인증 만들기](https://sendwich.kr/docs/quickstart/)에서 프로젝트 생성부터 결과 조회까지 진행할 수 있습니다.

## 서비스 주소

| 역할 | 주소 |
| --- | --- |
| 홈페이지·대시보드·문서 | `https://sendwich.kr` |
| 인증 API | `https://api.sendwich.kr` |
| sendwich 인증 창 | `https://id.it.kr` |

## 주요 문서

- [보내는 번호와 받는 번호](https://sendwich.kr/docs/phone-numbers/): 발신 번호, 수신 번호, 지원 형식
- [인증 생성](https://sendwich.kr/docs/api/create/): 요청 필드, 응답, 중복 생성 방지
- [웹훅](https://sendwich.kr/docs/webhooks/): 이벤트 수신과 서명 검증
- [요금제와 사용량](https://sendwich.kr/docs/usage/): 기능 비교와 호출 집계
- [LLM용 문서](https://sendwich.kr/docs/llms/): Markdown과 OpenAPI 명세