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

Mengirimkan kode konfirmasi 6 digit yang berlaku selama 10 menit ke alamat email yang diberikan — langkah pertama sebelum mengajukan permintaan akses.

`POST /api/public/access-request/email/start-verification` memulai verifikasi email untuk permohonan akses publik. Request ini tidak memerlukan login dan berisi alamat yang akan diverifikasi di field body `email`. Jika berhasil diproses, sistem mengirimkan kode konfirmasi enam digit yang berlaku selama sepuluh menit. Response berisi `ok`, sebuah `verification_id`, `expires_in_minutes`, dan `resend_cooldown_seconds`. `verification_id` harus digunakan bersama alamat email yang sama dan kode yang diterima pada route Verify berikutnya. Ini bukan token login dan tidak boleh disimpan sebagai identitas pengguna permanen atau dicatat secara publik. Endpoint ini tidak idempoten. Beberapa panggilan yang berhasil dapat menghasilkan beberapa proses verifikasi atau kode baru. Karena itu berlaku batas ketat berbasis IP sebesar sepuluh request dalam 15 menit. Selain itu, response menunjukkan masa tunggu pengiriman ulang selama 60 detik. Selama waktu tersebut, antarmuka tidak boleh memicu pengiriman ulang dan harus menampilkan sisa waktu tunggu dengan jelas. Jika batas terlampaui, route merespons dengan `429 RATE_LIMIT_EXCEEDED`. Jika kode tidak dapat dikirim karena kesalahan pengiriman, `502 MAIL_NOT_SENT` terdokumentasi. Kedua kasus ini harus ditangani secara terpisah: rate limit diatasi dengan menunggu, sedangkan kesalahan email memerlukan alamat yang dapat dijangkau dan pengiriman yang berfungsi. Secret atau data internal server email tidak boleh dicantumkan dalam pesan kesalahan. Kasus berhasil telah diverifikasi secara live dengan `verification_id` asli. Pesan terkait diterima melalui server fake SMTP milik sendiri dan kode enam digit dibaca dari isi email yang sebenarnya. Selain itu, kasus negatif 429 teramati setelah panggilan berulang. Bukti inilah yang boleh disebutkan; hal ini belum berarti permohonan akses atau proses pembayaran telah berhasil diselesaikan.

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

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