POST/api/public/access-request/email/start-verification

Ithumela ikhodi yokuqinisekisa enezinombolo ezingu-6, evumelekileyo imizuzu engu-10, ekheli le-imeyili elinikeziweyo — isinyathelo sokuqala ngaphambi kwesicelo sokufinyelela.

I-`POST /api/public/access-request/email/start-verification` iqalisa ukuqinisekiswa kwe-imeyili kwesicelo sokungena somphakathi. Isicelo kasidingi ukungena njalo siqukethe ikheli elizahlolwa enkundleni ye-body `email`. Nxa ukusetshenzwa kuphumelele, uhlelo luthumela ikhodi yokuqinisekisa eyizinombolo eziyisithupha, esebenza imizuzu elitshumi. Impendulo iqukethe i-`ok`, i-`verification_id`, i-`expires_in_minutes` le-`resend_cooldown_seconds`. I-`verification_id` kumele isetshenziswe kanye lekheli le-imeyili elifananayo lekhodi etholakeleyo emzileni we-Verify olandelayo. Kayisiyo i-token yokungena njalo kayimelanga igcinwe njengesihlonzi somsebenzisi esihlala njalo kumbe ibhalwe kulogi yomphakathi. I-endpoint kayisi-idempotent. Izibizo ezinengi eziphumeleleyo zingadala izinqubo zokuqinisekisa ezinengi kumbe amakhodi amatsha. Ngakho kusebenza umkhawulo oqinileyo osekelwe ku-IP wezicelo ezilitshumi phakathi kwemizuzu engu-15. Ngaphezu kwalokho impendulo ikhomba ukuvinjwa kokuphinda okwemizuzwana engu-60. Isikhangelo kasimelanga siqalise ukuthumela futhi ngalesi sikhathi njalo kumele sibonise ngokucacileyo isikhathi sokulinda esisele. Nxa umkhawulo weqiwa, umzila uphendula nge-`429 RATE_LIMIT_EXCEEDED`. Nxa ikhodi ingelakuthunyelwa ngenxa yephutha lokulethwa, kubhaliwe i-`502 MAIL_NOT_SENT`. Lezi zimo kumele ziphathwe ngokwehlukeneyo: umkhawulo wezicelo uxazululwa ngokulinda, iphutha le-imeyili lidinga ikheli elifinyelelekayo lokulethwa okusebenzayo. Izimfihlo kumbe idatha yangaphakathi yeseva ye-imeyili kakumelanga kube semlayezweni wephutha. Isimo sempumelelo siqinisekisiwe kuphila nge-`verification_id` yeqiniso. Umlayezo ohambelana laso wamukelwe ngeseva ye-SMTP yokuzenzisa eyethu, njalo ikhodi yezinombolo eziyisithupha yafundwa kokuqukethwe yi-imeyili yeqiniso. Ngaphezu kwalokho isimo esiphikisayo se-429 sabonwa ngemva kwezibizo eziphindiweyo. Lobu bufakazi kuphela obungakhulunywa; kabutsho ukuthi isicelo sokungena kumbe inqubo yokubhadala kuphelile ngempumelelo.

{"email":"max@example.com"}

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}