POST/api/public/access-request

يقدّم طلب وصول لباقة (Starter أو المخصصة (Individuell) أو عرض تجريبي لمدة 14 يومًا). ويتطلب ذلك عنوان بريد إلكتروني مؤكَّدًا مسبقًا.

أكّدوا أولًا عنوان البريد الإلكتروني عبر `POST /api/public/access-request/email/start-verification` و`POST /api/public/access-request/email/verify`. ثم أرسلوا `name`، ونفس `email`، والباقة `package` (`starter` أو `individual` أو `demo_access`)، و`verification_token` الذي حصلتم عليه. والحقول الاختيارية هي `company` و`phone` و`companyWebsite` و`paymentMethod` (`paypal` أو `kreditkarte` أو `rechnung` أو `stripe_card` أو `stripe_sepa`) و`wish` (`trial` أو `subscription` أو `offer`؛ وفي حالة الوصول التجريبي تكون دائمًا `trial`) و`message`. دون تأكيد صالح، يردّ الخادم بـ 400 `EMAIL_NOT_VERIFIED`. وتؤدي الحقول الإلزامية المفقودة أو القيم غير الصالحة للباقة أو طريقة الدفع أو الرغبة إلى 400 `VALIDATION_ERROR`. وينشأ كل طلب ناجح من جديد وتتولى Zentor معالجته؛ لذا لا تكرروا الاستدعاء تلقائيًا. بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان IP. وتنطبق أيضًا قواعد وصول Zentor (قواعد IP والدولة ونطاق البريد الإلكتروني)؛ وتحصل الاستدعاءات المرفوضة على 403.

نظرة عامة

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

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

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

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

المعلمات

name(body, string، إلزامي)— الاسم، 2–120 حرفًا
email(body, string، إلزامي)— عنوان البريد الإلكتروني الذي سبق تأكيده عبر `/email/verify`
package(body, string، إلزامي)— الباقة: `starter` أو `individual` أو `demo_access`
company(body, string)— الشركة، بحد أقصى 160 حرفًا (اختياري)
phone(body, string)— رقم الهاتف، بحد أقصى 40 حرفًا (اختياري)
companyWebsite(body, string)— موقع الشركة الإلكتروني، بحد أقصى 200 حرف (اختياري)
paymentMethod(body, string)— طريقة الدفع: `paypal` أو `kreditkarte` أو `rechnung` أو `stripe_card` أو `stripe_sepa` (اختياري)
wish(body, string)— الرغبة: `trial` أو `subscription` أو `offer`؛ ومع `demo_access` دائمًا `trial` (اختياري)
message(body, string)— الرسالة، بحد أقصى 3000 حرف (اختياري)

مثال طلب

{"name":"أحمد محمد","email":"max@example.com","package":"demo_access"}

مثال استجابة

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

رموز الأخطاء

400 VALIDATION_ERROR — حقل إلزامي مفقود، أو الباقة أو طريقة الدفع أو الرغبة غير صالحة.
400 EMAIL_NOT_VERIFIED — لم يُؤكَّد عنوان البريد الإلكتروني مسبقًا عبر `/email/start-verification` و`/email/verify`، أو `verification_token` مفقود أو غير صالح.

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

يُعيد المتن الفارغ 400 `VALIDATION_ERROR`؛ وتُعيد بيانات صالحة دون عنوان بريد إلكتروني مؤكَّد 400 `EMAIL_NOT_VERIFIED`. وتتبع حالة النجاح التسلسل الموثَّق بعد تأكيد البريد الإلكتروني.

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

POST /api/public/contactيستقبل طلبًا من نموذج الاتصال بموقع Zentor App الإلكتروني ويحوّله إلى فريق Zentor.POST /api/public/consultationيستقبل طلب استشارة من نموذج موقع Zentor App الإلكتروني.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يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.

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

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