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

Belirtilen e-posta adresine, 10 dakika geçerli altı haneli bir onay kodu gönderir – bir erişim talebinin ilk adımı.

Onaylanacak adresi `email` alanında gönderin. Yanıt, `verification_id`, `expires_in_minutes` (10) ve `resend_cooldown_seconds` (60) içerir. `verification_id`'yi aynı e-posta adresi ve alınan kodla birlikte `POST /api/public/access-request/email/verify`'da kullanın. Yeni bir kod ancak bekleme süresi geçtikten sonra gönderilebilir; kalan süreyi arayüzünüzde gösterin. Limit aşılırsa, uç nokta 429 `RATE_LIMIT_EXCEEDED` ile yanıt verir. E-posta teslim edilemezse, 502 `MAIL_NOT_SENT` ile yanıt verir; bu durumda adresi kontrol edin ve daha sonra tekrar deneyin.

Genel Bakış

Çağrı: POST /api/public/access-request/email/start-verification. Bu uç nokta, Zentor App API'sinin “Genel Formlar” grubuna aittir. Herkese açıktır ve kimlik doğrulama gerektirmez. Çağrı idempotent değildir: Her başarılı çağrı işlemi yeniden tetikler. Zorunlu parametreler: email (Body). Belgelenmiş hata durumları: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Aşağıdaki örnek yanıt, JSON formatındaki başarılı bir yanıtın yapısını gösterir.

Kimlik Doğrulama ve Güvenlik

Kimlik doğrulama gerekmez

Her IP adresi için 15 dakikada en fazla 10 istek. Ayrıca Zentor'un erişim kuralları geçerlidir (IP, ülke ve e-posta alan adı kuralları); reddedilen çağrılar 403 alır.

Hız Sınırı: 10 Anfragen pro 15 Minuten (IP-basiert)

İdempotent: Hayır

Parametreler

email(body, string, zorunlu)— Onaylanacak e-posta adresi

Örnek İstek

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

Örnek Yanıt

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

Hata Kodları

429 RATE_LIMIT_EXCEEDED — Bu IP adresinden çok fazla istek. Yeni bir kod istemeden önce bekleyin.
502 MAIL_NOT_SENT — Onay kodu e-posta ile gönderilemedi.

Doğrulanmış davranış

Çağrı, `verification_id` ile 200 döner ve kod e-posta ile gönderilir; tekrarlanan çağrılar 429 `RATE_LIMIT_EXCEEDED` döner.

Genel Formlar

POST /api/public/contactZentor App web sitesinin iletişim formundan bir talebi alır ve Zentor ekibine iletir.POST /api/public/consultationZentor App web sitesinin formundan bir danışmanlık talebi alır.POST /api/public/access-requestBir paket için erişim talebi gönderir (Starter, Bireysel veya 14 günlük demo). Önceden onaylanmış bir e-posta adresi gerekir.POST /api/public/access-request/email/verifyE-posta ile gönderilen kodu kontrol eder ve sonraki erişim talebi için bir onay belirteci (token) verir.GET /api/public/access-request/payment-statusErişim talebi için şu anda hangi ödeme yollarının (PayPal, Stripe) kullanılabilir olduğunu bildirir.GET /api/public/access-request/paypal/configÖdeme adımı için herkese açık PayPal yapılandırmasını (etkin, mod, para birimi) döndürür.POST /api/public/access-request/paypal/create-orderSeçilen paket için bir PayPal siparişi oluşturur.POST /api/public/access-request/paypal/capture-orderDaha önce oluşturulmuş ve alıcı tarafından PayPal ödeme sayfasında onaylanmış bir siparişi tamamlar (capture). Tutarı yalnızca sunucu belirler.POST /api/public/access-request/stripe/create-checkoutSeçilen paket için bir Stripe ödeme oturumu (checkout) oluşturur.POST /api/public/activate-accountYeni oluşturulan bir kullanıcı hesabını etkinleştirir ve ilk parolayı belirler – davet e-postasındaki bağlantı üzerinden tetiklenir.

İlgili makaleler

← Genel Formlar