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

Seol cód dearcaithe 6-sifre, a bhíonn inniu amháin ar feadh 10 nóiméad, chuig an r-phost a luaitear – is é an chéad céim roimh iarratas ar rochtain.

`POST /api/public/access-request/email/start-verification` tosna an tarcháil ríomhphoist le haghaidh iarratas ar rochtain phoiblí. Ní gá logáil isteach don iarratas seo, agus tá an adres a bhíonn scrúdaithe san fholaíocht `email`. Má éiríonn leis an bpróiseáil, seolann an chóras cód dearcaithe seisear digite, a bhíonn fiúint ar feadh deich mionúta. Áirítear `ok`, `verification_id`, `expires_in_minutes` agus `resend_cooldown_seconds` sa bhfreagairt. Caithfear `verification_id` a úsáid in éineacht le gurb é an t-adres ríomhphoist céanna agus an cód a fuarthas sa rian "Verify" ina dhiaidh. Ní token logála é, agus níor cheart é a stóráil mar aitheantóir úinéara buan ná a logadh go poiblí. Ní féidir le deireadh pointe seo a bheith idir-phróiseáilte. Féadfaidh roinnt glaonn rathúla a bheith ina gcúlra do roinnt próisis dearcaithe nó do chóid nua. Mar sin, tá teorainn cruas bunaithe ar IP de dhéic iarratais le haghaidh 15 nóiméad. Ina theannta sin, léiríonn an freagairt bac isteach arís de 60 nóiméad. Le linn am seo, níor cheart don ghnóthú a spreag an t-umrá, agus ba cheart an t-am fóillimh fágtha a chraoladh go soiléir. Má thit an teorainn isteach, freagrach an rian le `429 RATE_LIMIT_EXCEEDED`. Má ní féidir an cód a sheoladh mar gheall ar earráid seolta, tá `502 MAIL_NOT_SENT` cláraithe. Ba cheart go ndéanfar é seo ar leith: déantar an teorainn a réiteach trí fuireach, agus éilíonn earráid ríomhphoist adres inrochtana agus seoltóireacht oibríoch. Níor cheart eolas faoi rúin ná sonraí freisireachta ríomhphoist a bheith i measc an teachtaireachta briste. Cruthaíodh an t-amhrann rathúil agus deartha é le `verification_id` fíor. Fuarthas an t-fhreagairt trí shearchaire SMTP bréige, agus léadh an cód seisear digite ón ábhar ríomhphoist fíor. Chomh maith leis sin, d'fhéachadh ar an gcás neamhrathúil 429 tar éis glaonn a dhéanamh arís. Ba cheart go mbeadh an cruthúnas seo amháin a lua; ní chiallaíonn sé go bhfuil iarratas rochtana nó próiseáil íocaíochta críochnaithe go fíor.

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

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