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

Ithumela ikhodi yokuqinisekisa enezinhlamvu ezi-6, esebenza imizuzu eyi-10, ekheli le-imeyili elinikeziwe — isinyathelo sokuqala ngaphambi kwesicelo sokufinyelela.

`POST /api/public/access-request/email/start-verification` iqala ukuqinisekiswa kwe-imeyili kwesicelo sokufinyelela somphakathi. Isicelo asidingi ukungena futhi siqukethe ikheli okufanele lihlolwe enkambuni ye-body `email`. Uma ukucubungula kuphumelela, isistimu ithumela ikhodi yokuqinisekisa enezinombolo eziyisithupha, esebenza imizuzu eyishumi. Impendulo iqukethe `ok`, i-`verification_id`, `expires_in_minutes` ne-`resend_cooldown_seconds`. I-`verification_id` kufanele isetshenziswe kanye nekheli le-imeyili elifanayo nekhodi etholiwe emzileni we-verify olandelayo. Ayiyona i-token yokungena futhi akufanele igcinwe njengesihlonzi somsebenzisi esihlala njalo noma irekhodwe esidlangalaleni. I-endpoint ayiyona i-idempotent. Izingcingo eziningi eziphumelelayo zingadala izinqubo eziningi zokuqinisekisa noma amakhodi amasha. Ngakho kusebenza umkhawulo oqinile osekelwe ku-IP wezicelo eziyishumi phakathi kwemizuzu engu-15. Ngaphezu kwalokho, impendulo ikhomba isikhathi sokuvinjelwa kokuphinda esingamasekhondi angu-60. I-interface akufanele iqalise ukuthumela kabusha ngalesi sikhathi futhi kufanele ibonise ngokucacile isikhathi sokulinda esisele. Uma umkhawulo weqiwa, umzila uphendula nge-`429 RATE_LIMIT_EXCEEDED`. Uma ikhodi ingakwazi ukuthunyelwa ngenxa yephutha lokulethwa, kubhaliwe u-`502 MAIL_NOT_SENT`. Lezi zimo kufanele ziphathwe ngokwehlukana: umkhawulo wezinga uxazululwa ngokulinda, iphutha le-imeyili lidinga ikheli elifinyelelekayo nokulethwa okusebenzayo. Izimfihlo noma idatha yangaphakathi yeseva ye-imeyili akufanele kube semlayezweni wephutha. Icala lempumelelo liqinisekiswe bukhoma nge-`verification_id` yangempela. Umlayezo ohambisana nalo watholwa ngeseva yethu ye-SMTP mbumbulu futhi ikhodi enezinombolo eziyisithupha yafundwa kokuqukethwe kwe-imeyili yangempela. Ngaphezu kwalokho, icala elingalungile le-429 labonwa ngemva kokubiza kaningi. Yilobu bufakazi kuphela obungashiwo; akulandeli kulokhu ukuthi isicelo sokufinyelela noma inqubo yenkokhelo iqedwe ngempumelelo.

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

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