POST/api/public/access-request/email/verify

يتحقق من الرمز المرسَل عبر البريد الإلكتروني ويُصدر رمز تأكيد لطلب الوصول اللاحق.

أرسلوا `verification_id` (من `start-verification`)، ونفس `email`، والرمز المكوّن من ستة أرقام `code`. وفي حال النجاح، يحتوي الرد على `verified: true` و`verification_token` الذي ترسلونه عند تقديم طلب الوصول عبر `POST /api/public/access-request`. ويؤدي رمز خاطئ أو منتهي الصلاحية، أو `verification_id` غير مطابق، أو عنوان بريد إلكتروني مختلف، إلى 400 `VERIFY_FAILED`. في هذه الحالة، اطلبوا رمزًا جديدًا. والرمز صالح لهذا عنوان البريد الإلكتروني فقط، ويجب ألا يظهر في عناوين URL أو السجلات. بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان IP.

نظرة عامة

الاستدعاء: POST /api/public/access-request/email/verify. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: verification_id (النص (Body)), email (النص (Body)), code (النص (Body)). حالات الخطأ الموثقة: 400 VERIFY_FAILED. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

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

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

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

المعلمات

verification_id(body, string، إلزامي)— `verification_id` من `start-verification`
email(body, string، إلزامي)— نفس عنوان البريد الإلكتروني المستخدَم عند طلب الرمز
code(body, string، إلزامي)— رمز مكوّن من ستة أرقام من البريد الإلكتروني

مثال طلب

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

مثال استجابة

{"ok":true,"verified":true,"verification_token":"<رمز لطلب الوصول اللاحق>"}

رموز الأخطاء

400 VERIFY_FAILED — الرمز أو `verification_id` أو عنوان البريد الإلكتروني خاطئ، أو انتهت صلاحية الرمز.

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

يؤدي رمز خاطئ إلى 400 `VERIFY_FAILED`. وتتوافق حالة النجاح مع تأكيد البريد الإلكتروني في مُهيّئ المنتج.

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

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/start-verificationيرسل رمز تأكيد مكوّنًا من ستة أرقام وصالحًا لمدة 10 دقائق إلى عنوان البريد الإلكتروني المحدَّد – الخطوة الأولى في طلب الوصول.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يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.

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

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