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

Inotumira kodhi yekusimbisa ine manhamba 6, inoshanda kwemaminitsi 10, kukero yeemail yakataurwa — nhanho yekutanga chikumbiro chemukana chisati chaitwa.

`POST /api/public/access-request/email/start-verification` inotanga kusimbiswa kweemail pachikumbiro chekupinda cheruzhinji. Chikumbiro hachidi kupinda uye chine kero inofanira kuongororwa mumunda weBody `email`. Kana kugadzirisa kwabudirira, sisitimu inotumira kodhi yekusimbisa ine manhamba matanhatu inoshanda kwemaminitsi gumi. Mhinduro ine `ok`, `verification_id`, `expires_in_minutes` ne`resend_cooldown_seconds`. `verification_id` inofanira kushandiswa pamwe chete nekero imwe chete yeemail nekodhi yakagamuchirwa munzira yeVerify inotevera. Haisi token yekupinda uye haifanirwe kuchengetwa sechiratidzo chemushandisi chechigarire kana kunyorwa pachena. Endpoint iyi haisi idempotent. Kufona kwakabudirira kwakawanda kunogona kugadzira kusimbiswa kwakawanda kana makodhi matsva. Nokudaro kune muganhu wakasimba unoenderana neIP wezvikumbiro gumi mukati memaminitsi 15. Pamusoro pezvo, mhinduro inoratidza kumisa kwekudzokorora kwemasekondi 60. Interface haifanirwe kutangisa kutumira zvakare panguva iyi uye inofanira kuratidza nguva yasara yekumirira zvinonzwisisika. Kana muganhu wapfuurwa, nzira inopindura ne`429 RATE_LIMIT_EXCEEDED`. Kana kodhi isingagoni kutumirwa nekuda kwekukanganisa kwekusvitsa, `502 MAIL_NOT_SENT` yakanyorwa. Nyaya idzi dzinofanira kubatwa zvakasiyana: muganhu wehuwandu unogadziriswa nekumirira, kukanganisa kweemail kunoda kero inosvikika nekusvitsa kunoshanda. Zvakavanzika kana data remukati remail server hazvifanirwe kuva mumeseji yekukanganisa. Nyaya yekubudirira yakasimbiswa live ne`verification_id` chaiyo. Meseji yakabatana nazvo yakagamuchirwa kuburikidza neFake-SMTP server yedu pachedu uye kodhi ine manhamba matanhatu yakaverengwa kubva muzviri mukati meemail chaiyo. Uyezve, nyaya yakaipa ye429 yakaonekwa mushure mekufona kwakadzokororwa. Humbowo uhu chete ndihwo hunogona kududzwa; hazvireve kuti chikumbiro chekupinda kana kubhadhara zvakapedzwa zvichibudirira.

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

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