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

Ithumela ikhowudi yokuqinisekisa eneendawo ezi-6, esebenza imizuzu eyi-10, kwidilesi ye-imeyile enikiweyo — inyathelo lokuqala phambi kwesicelo sokufikelela.

`POST /api/public/access-request/email/start-verification` iqala uqinisekiso lwe-imeyile kwisicelo sokufikelela soluntu. Isicelo asifuni kungena kwaye siqulathe idilesi ekufuneka ihlolwe kwintsimi ye-body `email`. Xa ukucutshungulwa kuphumelele, isistim ithumela ikhowudi yokuqinisekisa enamanani amathandathu, esebenza imizuzu elishumi. Impendulo iqulathe `ok`, i-`verification_id`, `expires_in_minutes` kunye ne-`resend_cooldown_seconds`. I-`verification_id` kufuneka isetyenziswe kunye nedilesi ye-imeyile efanayo nekhowudi efunyenweyo kwindlela ye-verify elandelayo. Ayiyo-token yokungena kwaye akufuneki igcinwe njengesazisi somsebenzisi esisisigxina okanye ibhalwe kwilogi yoluntu. Indawo yokuphela ayiyo-idempotent. Ukubizwa okuninzi okuphumeleleyo kunokwenza iinkqubo ezininzi zoqinisekiso okanye iikhowudi ezintsha. Ngenxa yoko kusebenza umda ongqongqo osekelwe kwi-IP wezicelo ezilishumi kwimizuzu eli-15. Ukongeza, impendulo ibonisa ixesha lokuthintela ukuphinda lemizuzwana engama-60. Ujongano akufuneki luqalise ukuthumela kwakhona ngeli xesha kwaye kufuneka lubonise ngokucacileyo ixesha lokulinda eliseleyo. Ukuba umda udlulwe, indlela iphendula nge-`429 RATE_LIMIT_EXCEEDED`. Ukuba ikhowudi ayinakuthunyelwa ngenxa yempazamo yokuhanjiswa, kubhalwe i-`502 MAIL_NOT_SENT`. Ezi meko kufuneka ziphathwe ngokwahlukeneyo: umda wesantya usonjululwa ngokulinda, impazamo ye-imeyile ifuna idilesi efikelelekayo nokuhanjiswa okusebenzayo. Iimfihlo okanye idatha yangaphakathi yeseva ye-imeyile azifanelanga kumyalezo wempazamo. Imeko yempumelelo iqinisekiswe ngokuphilayo nge-`verification_id` yokwenyani. Umyalezo onxulumeneyo wafunyanwa ngeseva yethu ye-SMTP yomgunyathi, kwaye ikhowudi enamanani amathandathu yafundwa kumxholo we-imeyile wokwenyani. Ukongeza, imeko engalunganga ye-429 yabonwa emva kokubizwa okuphindiweyo. Obu bungqina kanye bunokukhankanywa; oku akuthethi ukuba isicelo sokufikelela okanye intlawulo igqitywe ngempumelelo.

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

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