문서/인증 이해하기

인증 모드

발신 번호를 확인하는 discover와 지정한 번호를 검증하는 match

모드 선택#

모드	확인 대상	사용 예
`discover`	인증 문자를 보낸 번호	회원가입, 봇 인증
`match`	지정한 번호와 실제 발신 번호의 일치 여부	기존 번호 확인, 번호 변경

모드는 인증 창과 API 직접 연동에서 동일하게 동작합니다. 요청 필드의 조건은 인증 생성을 참고합니다.

인증 문자를 보낸 번호를 결과의 phone으로 반환합니다.

json

{
  "mode": "discover",
  "client_reference": "attempt_93a7"
}

코드를 전달받은 다른 사람도 자신의 번호로 인증을 완료할 수 있으므로, 코드와 링크는 인증을 시작한 사용자에게만 표시합니다.

expected_phone에 지정한 번호에서 인증 문자를 수신해야 완료됩니다. 다른 번호에서 같은 문자를 보내면 pending 상태를 유지합니다.

json

{
  "mode": "match",
  "expected_phone": "010-1234-5678",
  "client_reference": "attempt_93a7"
}

인증 ID와 서비스의 사용자·시도를 서버에 저장하고, 조회 결과 또는 웹훅과 대조한 뒤 번호를 연결합니다. 한 번호의 다중 계정 사용 허용 여부는 서비스에서 정합니다.