ReOTP.
API/1. 백그라운드 링크 요청 (Zero-Delay)
1 분 분량

1. 백그라운드 링크 요청 (Zero-Delay)

사용자가 로그인 버튼을 누르기 전, 지연 없이 비공개로 인증 링크를 가져옵니다.

ReOTP 시스템은 "번호 입력 없는 로그인"(Zero-Type Auth) 경험을 제공하도록 설계되었습니다. WhatsApp 또는 Telegram 링크 요청을 보내기만 하면, 사용자가 보내는 메시지에서 전화번호를 자동으로 추출합니다!

요청 본문 (Request Body):

  • apiKey (문자열 - 필수): 프로젝트의 API 키.
  • phoneNumber (문자열 - 선택): 사용자의 전화번호 (예: +966500000000). 전달되지 않을 경우 발신자로부터 번호를 자동 추출합니다.
  • method (문자열 - 필수): "WHATSAPP" 또는 "TELEGRAM"이어야 합니다.
  • returnUrl (문자열 - 선택): Telegram에서 성공 후 돌아올 리다이렉트 URL.

응답 본문 (Response Body):

  • requestId (문자열): 상태 추적을 위한 작업 ID.
  • waLink (문자열): 생성된 WhatsApp 링크.
  • tgLink (문자열): 생성된 Telegram 링크.
  • expectedText (문자열): 자동 전송할 메시지 텍스트.

이 링크들을 수신한 후 로그인 버튼에 연결하면, 사용자가 버튼을 누를 때 한 번의 클릭으로 WhatsApp 또는 Telegram이 열립니다.

연동 코드 (SDK)
curl -X POST https://[your-domain.com]/api/verify/init \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "method": "WHATSAPP"
  }'
대화형 플레이그라운드
API 테스트용 대화형 플랫폼

전화번호를 입력하여 세션을 초기화하고 서버 응답을 실시간으로 테스트하세요:

직접 인터랙티브 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"
  }'