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

Ji bo ku hûn bikaribin bi awayekî baş têkilî bi hevpeyvîna xwe bikin, hûn ê ji bo ku hûn bi hevpeyvîna xwe re têkilî bi hevpeyvîna xwe bikin, hûn ê ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji bo ku hûn ji ku hûn ji bo ku hûn ji bo ku hûn ji ku ji ku ji we re ji ku hûn ji ku hûn ji ku hûn ji ku ji ku ji ku hûn ji ku hûn ji ku ji ku ji ku ji ku ji ku ji ku hûn ji ku hûn ji ku ji ku ji ku ji ku ji ku ji ku hûn ji ku ji ku hûn ji ku ji ku ji ku ji ku hûn ji ku ji ku ji ku ji ku ji ku ji ku ji ku ji ku ji ku hûn ji ku hûn ji ku ji ku hûn ji ku ji ku ji ku hûn ji ku ji ku ji ku ji ku ku ku ji ku ku ji ku ji ku ku ku ku ku hûn ji ku ku ku ku ku ku hûn ji ku ku ku ku ji ku ku hûn ji ku ku ji ku ku ji ku ku ku ku ku ku ku ku ku ku ku

`POST /api/public/access-request/email/start-verification` verastkirina e-nameyê ji bo daxwazeke têketinê ya giştî dest pê dike. Daxwaz hewceyê têketinê nake û navnîşana ku divê were kontrolkirin di qada Body `email` de dihewîne. Di rewşa pêvajokirina serkeftî de, pergal koda piştrastkirinê ya şeş-hejmarî dişîne, ku deh xulekan derbasdar e. Bersiv `ok`, `verification_id`, `expires_in_minutes` û `resend_cooldown_seconds` dihewîne. Divê `verification_id` bi heman navnîşana e-nameyê û koda hatî wergirtin re di rêya Verify ya li pey de were bikaranîn. Ew ne Tokena Login e û nabe wekî nasnameya bikarhêner a domdar were tomarkirin an bi awayekî giştî were qeydkirin. Endpoint ne idempotent e. Gelek gazkirinên serkeftî dikarin gelek pêvajoyên verastkirinê an jî kodên nû çêbikin. Ji ber vê yekê sînoreke tund a li ser bingeha IP ya deh daxwaz di nav 15 xulekan de derbasdar e. Wekî din, bersiv behsa astengeke dubarekirinê ya 60 saniyeyan dike. Divê rû di vê demê de tu şandina nû dest pê neke û dema mayî ya bendewariyê bi awayekî têgihiştî nîşan bide. Heke sînor were derbaskirin, rê bi `429 RATE_LIMIT_EXCEEDED` bersivê dide. Heke kod ji ber xeletiyeke gihandinê neyê şandin, `502 MAIL_NOT_SENT` hatiye belgekirin. Divê ev rewş ji hev cuda werin dîtin: sînorê rêjeyê bi bendewariyê tê çareserkirin, xeletiyeke mailê navnîşaneke gihîştî û gihandineke xebatkar hewce dike. Sir an daneyên navxweyî yên serverê yên mailê nakevin nav peyama xeletiyê. Rewşa serkeftî bi `verification_id` a rastîn bi awayekî zindî hatiye verastkirin. Peyama têkildar bi rêya Fake-SMTP-Server-eke taybet hatiye wergirtin û koda şeş-hejmarî ji naveroka e-nameya rastîn hatiye xwendin. Wekî din, rewşa neyînî ya 429 piştî gazkirinên dubarekirî hatiye çavdêrîkirin. Tenê ev belge dikare were behskirin; ji vê tu daxwazeke têketinê an pêvajoyeke dayînê ya bi serkeftî qedandî pê ne encam dernakeve.

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

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