POST/api/public/contact
يستقبل طلبًا من نموذج الاتصال بموقع Zentor App الإلكتروني ويحوّله إلى فريق Zentor.
الحقول الإلزامية هي `name` (2–120 حرفًا)، و`email` (عنوان بريد إلكتروني صالح)، و`message` (10–3000 حرف)، و`consentGiven` التي يجب ضبطها على `true`. ويمكن اختياريًا إرسال `company` و`phone` و`topic`. وفي حال النجاح، يردّ الخادم بـ `{"ok":true}` ورسالة تأكيد. إذا كان حقل إلزامي مفقودًا أو غير صالح أو كانت الموافقة مفقودة، يردّ النقطة بـ 400 `VALIDATION_ERROR`؛ ويسرد الحقل `details` الأخطاء الفردية بحيث يمكنكم تمييز حقول الإدخال المتأثرة. وينشئ كل إرسال ناجح طلبًا جديدًا، فعطّلوا زر الإرسال حتى الرد ولا تكرروا الاستدعاء تلقائيًا. بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان IP. وتنطبق أيضًا قواعد وصول Zentor (قواعد IP والدولة ونطاق البريد الإلكتروني)؛ وتحصل الاستدعاءات المرفوضة على 403.
نظرة عامة
الاستدعاء: POST /api/public/contact. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: name (النص (Body)), email (النص (Body)), message (النص (Body)), consentGiven (النص (Body)). المعاملات الاختيارية: company (النص (Body)), phone (النص (Body)), topic (النص (Body)). حالات الخطأ الموثقة: 400 VALIDATION_ERROR. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.
المصادقة والأمان
لا يلزم أي مصادقة
متطابق القوة: لا
المعلمات
name(body, string، إلزامي)— الاسم، 2–120 حرفًاemail(body, string، إلزامي)— عنوان بريد إلكتروني صالحmessage(body, string، إلزامي)— الرسالة، 10–3000 حرفcompany(body, string)— الشركة (اختياري)phone(body, string)— رقم الهاتف (اختياري)topic(body, string)— موضوع الطلب (اختياري)consentGiven(body, boolean، إلزامي)— موافقة حماية البيانات، يجب أن تكون `true`مثال طلب
{"name":"أحمد محمد","email":"max@example.com","message":"رسالتك (10 أحرف على الأقل).","consentGiven":true}مثال استجابة
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}رموز الأخطاء
400 VALIDATION_ERROR — حقل إلزامي مفقود أو غير صالح، أو موافقة حماية البيانات مفقودة. ويحتوي `details` على رسائل الخطأ الفردية.السلوك المُتحقَّق منه
تعيد البيانات الكاملة 200؛ وتعيد الحقول الإلزامية المفقودة أو الموافقة المفقودة 400 `VALIDATION_ERROR`.
النماذج العامة
POST /api/public/consultationيستقبل طلب استشارة من نموذج موقع Zentor App الإلكتروني.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يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.