API/2. Duba matsayin tantancewa
1 minti na karatu
2. Duba matsayin tantancewa
Tambaya game da matsayin zaman tantancewa na yanzu.
Da zarar an fara aikin tantancewa kuma ka sami requestId, aikinka dole ne ya saurari matsayin zaman a ainihin lokacin (SSE (Server-Sent Events)) don sanin ko abokin ciniki ya aika saƙon cikin nasara ko a'a.
Shirin A: Hanyar aiki (SSE - mafi sauri):
- Ƙirƙiri haɗin
EventSourcezuwa wurin ƙarshe da aka nuna don ci gaba da kasancewa a haɗe.
- Da zarar an sami matsayin
"VERIFIED", ka dakatar da haɗin nan take kuma ka shigar da mai amfani cikin nasara.
Madadin sauraro (Fallbacks):
- Shirin B (Polling): Idan yanayin ɗaukar nauyin aikinka baya goyan bayan SSE, za ka iya yin tambayar gargajiya ta hanyar yin buƙatar
GETzuwa/api/verify/status?id=...kowane daƙiƙa 3.
- Shirin C (Webhooks): Za ka iya dogara ga sanarwar atomatik daga sabar mu zuwa sabarka kai tsaye. Kara karantawa a sashen Webhooks.
Matsayin zaman (Session States):
PENDING: Abokin ciniki bai aika saƙon ba tukuna. Ci gaba da sauraro.
VERIFIED: An aika saƙon kuma an tabbatar da lambar cikin nasara.
EXPIRED: Lokaci ya ƙare (bayan mintuna 2 a mafi yawa).
Lambar haɗawa (SDKs)
Soyayya API ya rawa (Interactive API Playground)
Soyayya kamar yin da aka sai amfani da wane, kuma kama kode Integration daga cikin lissafin da kai nuna.
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"
}'