API/2. 인증 상태 확인
1 분 분량
2. 인증 상태 확인
현재 인증 세션의 상태 조회.
인증 프로세스가 시작되고 requestId를 받은 후, 애플리케이션은 클라이언트가 메시지를 성공적으로 보냈는지 확인하기 위해 세션 상태를 실시간(SSE (Server-Sent Events))으로 감지해야 합니다.
방안 A: 작동 방식 (SSE - 가장 빠름):
- 지속적인 연결을 유지하기 위해 해당 엔드포인트로
EventSource연결을 생성합니다.
"VERIFIED"상태를 수신하면 즉시 연결을 종료하고 사용자를 로그인 처리합니다.
대체 수단 (Fallbacks):
- 방안 B (Polling): 호스팅 환경이 SSE를 지원하지 않는 경우, 3초마다
/api/verify/status?id=...로GET요청을 보내는 기존 폴링 방식을 사용할 수 있습니다.
- 방안 C (Webhooks): 당사 서버에서 귀하의 서버로 직접 전송되는 자동 알림에 의존할 수 있습니다. 자세한 내용은 Webhooks 섹션을 참조하세요.
반환 세션 상태 (Session States):
PENDING: 클라이언트가 아직 메시지를 보내지 않았습니다. 계속 대기하세요.
VERIFIED: 메시지가 전송되었으며 번호 검증이 완료되었습니다.
EXPIRED: 세션이 만료되었습니다 (최대 2분 후).
연동 코드 (SDK)
직접 인터랙티브 API 플레이그라운드 (Interactive API Playground)
검증 요청을 직접 보내고 선호하는 프로그래밍 언어로 통합 코드를 생성해 보세요.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'