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

Slanje 6-znamenkastog koda za potvrdu, koji je važeći 10 minuta, na navedenu e-mail adresu – prvi korak prije zahtjeva za pristup.

`POST /api/public/access-request/email/start-verification` pokreće provjeru e-adrese za javni zahtjev za pristup. Zahtjev ne traži prijavu i sadrži adresu koju treba provjeriti u polju tijela `email`. Nakon uspješne obrade sustav šalje šesteroznamenkasti kôd za potvrdu koji vrijedi deset minuta. Odgovor sadrži `ok`, `verification_id`, `expires_in_minutes` i `resend_cooldown_seconds`. `verification_id` mora se koristiti zajedno s istom e-adresom i primljenim kôdom u naknadnoj ruti za provjeru (verify). Nije token za prijavu i ne smije se pohranjivati kao trajni identifikator korisnika niti javno bilježiti u logovima. Krajnja točka nije idempotentna. Više uspješnih poziva može stvoriti više postupaka provjere odnosno nove kôdove. Zato vrijedi strogo ograničenje temeljeno na IP adresi od deset zahtjeva unutar 15 minuta. Osim toga, odgovor upućuje na blokadu ponovnog slanja od 60 sekundi. Sučelje tijekom tog vremena ne smije pokrenuti ponovno slanje i treba razumljivo prikazati preostalo vrijeme čekanja. Ako se ograničenje prekorači, ruta odgovara s `429 RATE_LIMIT_EXCEEDED`. Ako se kôd ne može poslati zbog pogreške pri dostavi, dokumentiran je `502 MAIL_NOT_SENT`. Te slučajeve treba obrađivati odvojeno: ograničenje broja zahtjeva rješava se čekanjem, a pogreška e-pošte zahtijeva dostupnu adresu i ispravnu dostavu. Tajni podaci ili interni podaci poslužitelja e-pošte ne pripadaju u poruku o pogrešci. Uspješan slučaj provjeren je uživo sa stvarnim `verification_id`. Pripadajuća poruka primljena je putem vlastitog lažnog SMTP poslužitelja, a šesteroznamenkasti kôd pročitan je iz stvarnog sadržaja e-poruke. Osim toga, uočen je i negativan slučaj 429 nakon ponovljenih poziva. Smije se navesti upravo taj dokaz; iz njega još ne proizlazi uspješno dovršen zahtjev za pristup ni postupak plaćanja.

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

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