POST/api/public/consultation

يستقبل طلب استشارة من نموذج موقع Zentor App الإلكتروني.

الحقول الإلزامية هي `name` (2–120 حرفًا)، و`email` (عنوان بريد إلكتروني صالح)، و`consentGiven` التي يجب ضبطها على `true`. ويمكن اختياريًا إرسال `company` و`phone` و`message`. وفي حال النجاح، يردّ الخادم بـ `{"ok":true}` ورسالة تأكيد؛ ويتواصل فريق Zentor معكم بعد ذلك. إذا كان حقل إلزامي مفقودًا أو غير صالح أو كانت الموافقة مفقودة، يردّ النقطة بـ 400 `VALIDATION_ERROR`. وينشئ كل استدعاء ناجح طلبًا جديدًا؛ وبالتالي فإن الاستدعاء غير idempotent. بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان IP. وتنطبق أيضًا قواعد وصول Zentor (قواعد IP والدولة ونطاق البريد الإلكتروني)؛ وتحصل الاستدعاءات المرفوضة على 403.

نظرة عامة

الاستدعاء: POST /api/public/consultation. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: name (النص (Body)), email (النص (Body)), consentGiven (النص (Body)). المعاملات الاختيارية: company (النص (Body)), message (النص (Body)), phone (النص (Body)). حالات الخطأ الموثقة: 400 VALIDATION_ERROR. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

المصادقة والأمان

لا يلزم أي مصادقة

متطابق القوة: لا

المعلمات

name(body, string، إلزامي)— الاسم، 2–120 حرفًا
email(body, string، إلزامي)— عنوان بريد إلكتروني صالح
company(body, string)— الشركة (اختياري)
message(body, string)— الرسالة (اختياري)
phone(body, string)— رقم الهاتف (اختياري)
consentGiven(body, boolean، إلزامي)— موافقة حماية البيانات، يجب أن تكون `true`

مثال طلب

{"name":"أحمد محمد","email":"max@example.com","company":"شركة نموذجية","message":"استفسار","consentGiven":true}

مثال استجابة

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

رموز الأخطاء

400 VALIDATION_ERROR — حقل إلزامي مفقود أو غير صالح، أو الموافقة مفقودة.

السلوك المُتحقَّق منه

تعيد البيانات الكاملة 200؛ وتعيد البيانات المفقودة أو غير الصالحة 400 `VALIDATION_ERROR`.

النماذج العامة

POST /api/public/contactيستقبل طلبًا من نموذج الاتصال بموقع Zentor App الإلكتروني ويحوّله إلى فريق Zentor.POST /api/public/access-requestيقدّم طلب وصول لباقة (Starter أو المخصصة (Individuell) أو عرض تجريبي لمدة 14 يومًا). ويتطلب ذلك عنوان بريد إلكتروني مؤكَّدًا مسبقًا.POST /api/public/access-request/email/start-verificationيرسل رمز تأكيد مكوّنًا من ستة أرقام وصالحًا لمدة 10 دقائق إلى عنوان البريد الإلكتروني المحدَّد – الخطوة الأولى في طلب الوصول.POST /api/public/access-request/email/verifyيتحقق من الرمز المرسَل عبر البريد الإلكتروني ويُصدر رمز تأكيد لطلب الوصول اللاحق.GET /api/public/access-request/payment-statusيبيّن طرق الدفع المتاحة حاليًا (PayPal، Stripe) لطلب الوصول.GET /api/public/access-request/paypal/configيعرض تهيئة PayPal العامة (مفعّلة، الوضع، العملة) لخطوة الدفع.POST /api/public/access-request/paypal/create-orderيُنشئ طلب شراء عبر PayPal للباقة المختارة.POST /api/public/access-request/paypal/capture-orderيُنهي طلبًا تم إنشاؤه مسبقًا وأقرّه المشتري في عملية الدفع عبر PayPal (Capture). والخادم وحده يحدّد المبلغ.POST /api/public/access-request/stripe/create-checkoutيُنشئ جلسة دفع عبر Stripe للباقة المختارة.POST /api/public/activate-accountيفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.

مقالات ذات صلة

← النماذج العامة