ReOTP.
API/2. Ṣàyẹ̀wò Ipò Ìfọwọ́sí
2 ìṣẹ́jú kíkà

2. Ṣàyẹ̀wò Ipò Ìfọwọ́sí

Béèrè nípa ipò àkókò ìfọwọ́sí lọ́wọ́lọ́wọ́.

Ní kété tí ìlànà ìfọwọ́sí bá ti bẹ̀rẹ̀ tí o sì ti gba requestId, ohun èlò rẹ gbọ́dọ̀ tẹ́tí sílẹ̀ ní àkókò gidi (SSE (Server-Sent Events)) sí ipò àkókò náà láti mọ̀ bóyá oníbàárà ti fi iṣẹ́-ìránṣẹ́ ránṣẹ́ pẹ̀lú àṣeyọrí.

Ètò A: Ìlànà Iṣẹ́ (SSE - Èyí tó yára jù):

  • Ṣẹ̀dá ìsopọ̀ EventSource sí endpoint tí a fihàn láti wà ní ìsopọ̀ títí lọ.
  • Ní kété tí o bá gba ipò "VERIFIED", parí ìsopọ̀ náà lẹ́sẹ̀kẹsẹ̀ kí o sì wọlé fún olùlò pẹ̀lú àṣeyọrí.

Àwọn Àṣàyàn Ìtẹ́tísílẹ̀ Mìíràn (Fallbacks):

  • Ètò B (Polling): Tí àyíká ìgbàlejò rẹ kò bá ṣe àtìlẹ́yìn fún SSE, o lè béèrè ní ọ̀nà àtọwọ́dọ́wọ́ nípa ṣíṣe ìbéèrè GET/api/verify/status?id=... ní gbogbo ìṣẹ́jú-àáyá 3.
  • Ètò C (Webhooks): O lè gbẹ́kẹ̀lé àwọn ìfitónilétí aládàáṣiṣẹ́ láti àwọn olupin wa sí olupin rẹ tààràtà. Ka síwájú síi nínú abala Webhooks.

Àwọn Ipò Àkókò (Session States):

  • PENDING: Oníbàárà kò tíì fi iṣẹ́-ìránṣẹ́ ránṣẹ́. Tẹ̀síwájú láti tẹ́tí sílẹ̀.
  • VERIFIED: A ti fi iṣẹ́-ìránṣẹ́ ránṣẹ́, a sì ti fọwọ́ sí nọ́mbà náà pẹ̀lú àṣeyọrí.
  • EXPIRED: Àkókò ti kọjá (lẹ́yìn ìṣẹ́jú 2 gẹ́gẹ́ bí ìwọ̀n tí ó pọ̀ jù).
Kóòdù Ìṣàkópọ̀ (SDKs)
curl -N https://[your-domain.com]/api/verify/stream?id=YOUR_REQUEST_ID

Ìgbé tó ní API tó ní ọ̀nà tó rọ̀ (Interactive API Playground)

Gòdó sọ̀rọ̀ sọ́rọ̀ tó ní ọ̀nà tó rọ̀, kí a ṣe àkóódì Integration nínú ìwé ẹ̀bọ̀ tó fé

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"
  }'