POST/api/public/activate-account
يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.
أرسلوا `token` (من رابط التفعيل في بريد الدعوة الإلكتروني) و`password` المطلوب. وفي حال النجاح، يصبح الحساب فعّالًا (`data.user_id`) ويسجّل المستخدم الدخول بكلمة المرور الجديدة. ورابط التفعيل صالح مرة واحدة فقط ولفترة محدودة. يؤدي رابط غير صالح أو مستخدَم مسبقًا أو منتهي الصلاحية إلى 400 `INVALID_TOKEN`؛ اطلبوا في هذه الحالة دعوة جديدة. والنقطة محدودة بـ10 طلبات كل 15 دقيقة لكل عنوان IP.
نظرة عامة
الاستدعاء: POST /api/public/activate-account. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: token (النص (Body)), password (النص (Body)). حالات الخطأ الموثقة: 400 INVALID_TOKEN. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.
المصادقة والأمان
لا يلزم أي مصادقة
متطابق القوة: لا
المعلمات
token(body, string، إلزامي)— رمز التفعيل من بريد الدعوة الإلكترونيpassword(body, string، إلزامي)— كلمة المرور المطلوب ضبطهامثال طلب
{"token":"<رمز من بريد التفعيل>","password":"كلمة مرورك الجديدة الآمنة!"}مثال استجابة
{"ok":true}رموز الأخطاء
400 INVALID_TOKEN — رابط التفعيل غير صالح أو مستخدَم مسبقًا أو منتهي الصلاحية.السلوك المُتحقَّق منه
يؤدي رمز غير صالح إلى 400 `INVALID_TOKEN`. وتتطلب حالة النجاح رابطًا صالحًا من بريد دعوة إلكتروني.
النماذج العامة
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 دقائق إلى عنوان البريد الإلكتروني المحدَّد – الخطوة الأولى في طلب الوصول.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 للباقة المختارة.