> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 전화번호 인증 API: SMS OTP 및 위험 신호

> 2단계 SMS OTP 인증과 통신사, 가상 번호, 일회용 번호 탐지를 제공하는 Didit 전화번호 인증 API. 사용한 만큼 과금: 통신사 요금 + $0.02 수수료, 계약 불필요.

전화번호 인증 API는 두 단계로 동작합니다. 전화번호로 일회용 코드를 보낸 뒤 그 코드를 확인합니다. 시스템은 이동통신사 유형, 가상 번호, 일회용 전화번호를 감지합니다.

## endpoint

> [card] [인증 코드 전송](https://docs.didit.me/ko/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/` — SMS로 일회용 인증 코드를 전송합니다.

> [card] [인증 코드 확인](https://docs.didit.me/ko/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/` — 코드를 확인하고 전화번호 위험 데이터를 가져옵니다.

> [card] [전화번호 위험 점수 산정](https://docs.didit.me/ko/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/` — OTP를 보내지 않고 이동통신사, 회선 유형, 번호 이동, 사기 위험을 점수로 산정합니다.

## 작동 방식

1. E.164 형식의 전화번호(예: `+14155552671`)와 함께 **인증 코드 전송**을 호출합니다.
2. 사용자는 SMS로 코드를 받습니다(5분 동안 유효).
3. 전화번호와 코드를 사용해 **인증 코드 확인**을 호출합니다.
4. 인증 결과와 위험 신호(이동통신사 유형, 가상 번호 감지)를 받습니다.

## 전송 채널

Didit은 국가별 지원 여부에 따라 여러 채널을 지원합니다.

| 채널 | 설명 |
| - | - |
| SMS | 표준 문자 메시지 |
| WhatsApp | WhatsApp 메시지 |
| Telegram | Telegram 메시지 |
| RCS | 리치 커뮤니케이션 서비스(RCS) |
| Viber | Viber 메시지 |

## 위험 신호

| 신호 | 설명 |
| - | - |
| `is_disposable` | 일시적이거나 일회용인 전화번호 |
| `is_virtual` | VoIP 또는 가상 번호 |
| `carrier.type` | `mobile`, `landline` 또는 `voip` |

전체 응답 구조는 [전화번호 인증 보고서](https://docs.didit.me/ko/core-technology/phone-verification/overview.md)를 참조하십시오.

## 제공업체 장애

상위 전화번호 제공업체가 전송 또는 확인 요청에 응답하지 못하면, 두 endpoint 모두 일반 오류 대신 `502`와 `code: "phone_provider_unavailable"`을 반환합니다. 이 응답은 재시도해도 안전하며, 요금이 청구되지 않고, 번호별 시간당 상한의 시도 횟수를 차지하지 않습니다. 메시지 문구는 안정적인 계약이 아니므로 `detail` 메시지를 파싱하지 말고 `code` 값에 따라 분기하십시오.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.