POST/api/public/access-request
Bir paket için erişim talebi gönderir (Starter, Bireysel veya 14 günlük demo). Önceden onaylanmış bir e-posta adresi gerekir.
Önce e-posta adresini `POST /api/public/access-request/email/start-verification` ve `POST /api/public/access-request/email/verify` üzerinden onaylayın. Ardından `name`, aynı `email`, paket `package` (`starter`, `individual` veya `demo_access`) ve alınan `verification_token`'ı gönderin. İsteğe bağlı olarak `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` veya `stripe_sepa`), `wish` (`trial`, `subscription` veya `offer`; demo erişiminde her zaman `trial`) ve `message` gönderilebilir. Geçerli bir onay yoksa, sunucu 400 `EMAIL_NOT_VERIFIED` ile yanıt verir. Zorunlu alanların eksik olması veya paket, ödeme yöntemi ya da istek için geçersiz değerler 400 `VALIDATION_ERROR` ile sonuçlanır. Her başarılı talep yeni olarak oluşturulur ve Zentor tarafından işlenir; bu nedenle ç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/access-request. 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), package (Body). İsteğe bağlı parametreler: company (Body), phone (Body), companyWebsite (Body), paymentMethod (Body), wish (Body), message (Body). Belgelenmiş hata durumları: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— Daha önce `/email/verify` üzerinden onaylanmış e-posta adresipackage(body, string, zorunlu)— Paket: `starter`, `individual` veya `demo_access`company(body, string)— Firma, en fazla 160 karakter (isteğe bağlı)phone(body, string)— Telefon numarası, en fazla 40 karakter (isteğe bağlı)companyWebsite(body, string)— Şirketin web sitesi, en fazla 200 karakter (isteğe bağlı)paymentMethod(body, string)— Ödeme yöntemi: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` veya `stripe_sepa` (isteğe bağlı)wish(body, string)— İstek: `trial`, `subscription` veya `offer`; `demo_access`'te her zaman `trial` (isteğe bağlı)message(body, string)— Mesaj, en fazla 3000 karakter (isteğe bağlı)Örnek İstek
{"name":"Ahmet Yılmaz","email":"max@example.com","package":"demo_access"}Örnek Yanıt
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}Hata Kodları
400 VALIDATION_ERROR — Zorunlu bir alan eksik, ya da paket, ödeme yöntemi veya istek geçersiz.400 EMAIL_NOT_VERIFIED — E-posta adresi `/email/start-verification` ve `/email/verify` üzerinden önceden onaylanmadı, veya `verification_token` eksik ya da geçersiz.Doğrulanmış davranış
Boş bir gövde 400 `VALIDATION_ERROR` döner; onaylı olmayan bir e-posta ile geçerli veriler 400 `EMAIL_NOT_VERIFIED` döner. Başarı durumu, e-posta onayından sonra belgelenen akışı takip eder.
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-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.