POST/api/public/access-request/email/start-verification
يرسل رمز تأكيد مكوّنًا من ستة أرقام وصالحًا لمدة 10 دقائق إلى عنوان البريد الإلكتروني المحدَّد – الخطوة الأولى في طلب الوصول.
أرسلوا العنوان المطلوب تأكيده في الحقل `email`. ويحتوي الرد على `verification_id` و`expires_in_minutes` (10) و`resend_cooldown_seconds` (60). استخدموا `verification_id` مع نفس عنوان البريد الإلكتروني والرمز المستلم في `POST /api/public/access-request/email/verify`. ولا يمكن إعادة الإرسال إلا بعد انتهاء فترة الانتظار؛ أظهروا الوقت المتبقي في واجهتكم. إذا تجاوزتم الحد، تردّ النقطة بـ 429 `RATE_LIMIT_EXCEEDED`. وإذا تعذّر تسليم البريد الإلكتروني، تردّ بـ 502 `MAIL_NOT_SENT`؛ تحققوا من العنوان حينها وحاولوا مرة أخرى لاحقًا.
نظرة عامة
الاستدعاء: POST /api/public/access-request/email/start-verification. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: email (النص (Body)). حالات الخطأ الموثقة: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.
المصادقة والأمان
لا يلزم أي مصادقة
بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان IP. وتنطبق أيضًا قواعد وصول Zentor (قواعد IP والدولة ونطاق البريد الإلكتروني)؛ وتحصل الاستدعاءات المرفوضة على 403.
حد المعدل: 10 Anfragen pro 15 Minuten (IP-basiert)
متطابق القوة: لا
المعلمات
email(body, string، إلزامي)— عنوان البريد الإلكتروني المطلوب تأكيدهمثال طلب
{"email":"max@example.com"}مثال استجابة
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}رموز الأخطاء
429 RATE_LIMIT_EXCEEDED — عدد كبير جدًا من الطلبات من هذا عنوان IP. انتظروا قبل طلب رمز جديد.502 MAIL_NOT_SENT — تعذّر تسليم رمز التأكيد عبر البريد الإلكتروني.السلوك المُتحقَّق منه
يُعيد الاستدعاء 200 مع `verification_id`، ويُسلَّم الرمز عبر البريد الإلكتروني؛ وتُعيد الاستدعاءات المتكررة 429 `RATE_LIMIT_EXCEEDED`.
النماذج العامة
POST /api/public/contactيستقبل طلبًا من نموذج الاتصال بموقع Zentor App الإلكتروني ويحوّله إلى فريق Zentor.POST /api/public/consultationيستقبل طلب استشارة من نموذج موقع Zentor App الإلكتروني.POST /api/public/access-requestيقدّم طلب وصول لباقة (Starter أو المخصصة (Individuell) أو عرض تجريبي لمدة 14 يومًا). ويتطلب ذلك عنوان بريد إلكتروني مؤكَّدًا مسبقًا.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يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.