ReOTP.
API/2. Semak Status Pengesahan
1 1-Minute Read

2. Semak Status Pengesahan

Semak status sesi pengesahan semasa.

Sebaik sahaja proses pengesahan bermula dan anda mendapat requestId, aplikasi anda mesti mendengar secara masa nyata (SSE (Server-Sent Events)) status sesi untuk mengetahui sama ada pelanggan telah berjaya menghantar mesej atau tidak.

Pelan A: Mekanisme Kerja (SSE - Terpantas):

  • Cipta sambungan EventSource ke titik akhir (endpoint) yang dinyatakan untuk kekal terhubung secara berterusan.
  • Sebaik sahaja memperoleh status "VERIFIED", tamatkan sambungan serta-merta dan log masuk pengguna secara berjaya.

Alternatif Mendengar (Fallbacks):

  • Pelan B (Polling): Jika persekitaran pengehosan anda tidak menyokong SSE, anda boleh membuat pertanyaan tradisional melalui permintaan GET ke /api/verify/status?id=... setiap 3 saat.
  • Pelan C (Webhooks): Anda boleh bergantung pada pemberitahuan automatik daripada pelayan kami terus ke pelayan anda. Baca lebih lanjut dalam bahagian Webhooks.

Status Ditemui (Session States):

  • PENDING: Pelanggan belum menghantar mesej. Teruskan mendengar.
  • VERIFIED: Mesej telah dihantar dan nombor berjaya disahkan.
  • EXPIRED: Telah tamat tempoh (maksimum selepas 2 minit).
Kod integrasi (SDKs)
curl -N https://reotp.com/api/verify/stream?id=YOUR_REQUEST_ID

Ruang Ujian API Interaktif (Interactive API Playground)

Cuba hantar permintaan pengesahan secara langsung dan jana kod integrasi dalam bahasa pengaturcaraan pilihan anda.

curl -X POST https://reotp.com/api/verify/init \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "201000000000",
    "method": "WHATSAPP"
  }'