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

​
endpoint

인증 코드 전송

POST /v3/phone/send/ — SMS로 일회용 인증 코드를 전송합니다.

인증 코드 확인

POST /v3/phone/check/ — 코드를 확인하고 전화번호 위험 데이터를 가져옵니다.

전화번호 위험 점수 산정

POST /v3/phone/risk/ — OTP를 보내지 않고 이동통신사, 회선 유형, 번호 이동, 사기 위험을 점수로 산정합니다.

​
작동 방식

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

​
전송 채널

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

​
위험 신호

전체 응답 구조는 전화번호 인증 보고서를 참조하십시오.

​
제공업체 장애

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