POST/api/public/consultation
Zentor App web sitesinin formundan bir danışmanlık talebi alır.
Zorunlu alanlar `name` (2–120 karakter), `email` (geçerli e-posta adresi) ve `true` olarak ayarlanması gereken `consentGiven`'dır. İsteğe bağlı olarak `company`, `phone` ve `message` gönderilebilir. Başarılı olursa sunucu `{"ok":true}` ve bir onay mesajıyla yanıt verir; ardından Zentor ekibi sizinle iletişime geçer. Zorunlu bir alan eksikse, geçersizse veya onay eksikse, uç nokta 400 `VALIDATION_ERROR` ile yanıt verir. Her başarılı çağrı yeni bir talep oluşturur; bu nedenle çağrı idempotent değildir. 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/consultation. 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), consentGiven (Body). İsteğe bağlı parametreler: company (Body), message (Body), phone (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 adresicompany(body, string)— Firma (isteğe bağlı)message(body, string)— Mesaj (isteğe bağlı)phone(body, string)— Telefon numarası (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","company":"Örnek Şirket","message":"Talep","consentGiven":true}Örnek Yanıt
{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}Hata Kodları
400 VALIDATION_ERROR — Zorunlu bir alan eksik veya geçersiz, ya da onay eksik.Doğrulanmış davranış
Eksiksiz bilgiler 200 döner; eksik veya geçersiz bilgiler 400 `VALIDATION_ERROR` 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/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.