POST/api/public/contact
Zentor App web sitesinin iletişim formundan bir talebi alır ve Zentor ekibine iletir.
Zorunlu alanlar `name` (2–120 karakter), `email` (geçerli e-posta adresi), `message` (10–3000 karakter) ve `true` olarak ayarlanması gereken `consentGiven`'dır. İsteğe bağlı olarak `company`, `phone` ve `topic` gönderilebilir. Başarılı olursa sunucu `{"ok":true}` ve bir onay mesajıyla yanıt verir. Zorunlu bir alan eksikse, geçersizse veya onay eksikse, uç nokta 400 `VALIDATION_ERROR` ile yanıt verir; `details` alanı tek tek hataları listeler, böylece ilgili giriş alanlarını işaretleyebilirsiniz. Her başarılı gönderim yeni bir talep oluşturur. Bu nedenle yanıt gelene kadar gönder düğmesini devre dışı bırakın ve çağrıyı otomatik olarak tekrarlamayın. 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.
Genel Bakış
Çağrı: POST /api/public/contact. 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: name (Body), email (Body), message (Body), consentGiven (Body). İsteğe bağlı parametreler: company (Body), phone (Body), topic (Body). Belgelenmiş hata durumları: 400 VALIDATION_ERROR. 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
İdempotent: Hayır
Parametreler
name(body, string, zorunlu)— Ad, 2–120 karakteremail(body, string, zorunlu)— Geçerli e-posta adresimessage(body, string, zorunlu)— Mesaj, 10–3000 karaktercompany(body, string)— Firma (isteğe bağlı)phone(body, string)— Telefon numarası (isteğe bağlı)topic(body, string)— Talebin konusu (isteğe bağlı)consentGiven(body, boolean, zorunlu)— Veri koruma onayı, `true` olmalıdırÖrnek İstek
{"name":"Ahmet Yılmaz","email":"max@example.com","message":"Mesajınız (en az 10 karakter).","consentGiven":true}Örnek Yanıt
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Hata Kodları
400 VALIDATION_ERROR — Zorunlu bir alan eksik veya geçersiz, ya da veri koruma onayı eksik. `details` tek tek hata mesajlarını içerir.Doğrulanmış davranış
Eksiksiz bilgiler 200 döner; eksik zorunlu alanlar veya eksik onay 400 `VALIDATION_ERROR` döner.
Genel Formlar
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/start-verificationBelirtilen e-posta adresine, 10 dakika geçerli altı haneli bir onay kodu gönderir – bir erişim talebinin ilk adımı.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.