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 karakter
email(body, string, zorunlu)— Geçerli e-posta adresi
message(body, string, zorunlu)— Mesaj, 10–3000 karakter
company(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.

İlgili makaleler

← Genel Formlar