ReOTP.
고급 기능/자동 알림 (Webhooks)
1 분 분량

자동 알림 (Webhooks)

자체 서버에서 인증 프로세스 업데이트를 즉시 수신합니다.

브라우저에서 리소스를 소모하며 주기적으로 조회(SSE (Server-Sent Events))하는 대신, 프로젝트 대시보드에서 웹훅 URL (Webhook URL)을 설정할 수 있습니다.

사용자의 전화번호 인증이 성공하면 ReOTP 서버가 작업 상세 정보가 포함된 POST 요청을 귀하의 서버로 직접 전송합니다.

보안 검증 (Webhook Signature)

대시보드에서 웹훅용 비밀키(Secret Key)를 설정한 경우, 당사는 요청 시 비밀키와 SHA256 알고리즘으로 암호화된 HMAC 서명이 포함된 x-webhook-signature 헤더를 함께 보냅니다. 이를 통해 요청이 당사로부터 전송되었고 변조되지 않았음을 검증할 수 있습니다.

연동 코드 (SDK)
{
  "event": "verification.success",
  "phoneNumber": "+966500000000",
  "actualPhoneNumber": "+966500000000",
  "requestId": "cmrjpk97j0000okc514kfdkll",
  "projectId": "cmrjpk97j00...",
  "method": "WHATSAPP",
  "timestamp": "2026-07-17T12:00:00.000Z"
}

직접 인터랙티브 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"
  }'
이전 아티클2. 인증 상태 확인
다음 아티클맞춤 WhatsApp 번호 연동