POST/api/public/access-request
کسی پیکیج (Starter، انفرادی یا 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 اس پر عمل کرتا ہے؛ اس لیے کال کو خودکار طور پر نہ دہرائیں۔ فی IP ایڈریس ہر 15 منٹ میں زیادہ سے زیادہ 10 درخواستیں۔ اس کے علاوہ Zentor کے رسائی قواعد (IP، ملک اور ای میل ڈومین قواعد) بھی لاگو ہوتے ہیں؛ مسترد کالز کو 403 ملتا ہے۔
جائزہ
کال: POST /api/public/access-request۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “عوامی فارمز” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: name (باڈی), email (باڈی), package (باڈی)۔ اختیاری پیرامیٹرز: company (باڈی), phone (باڈی), companyWebsite (باڈی), paymentMethod (باڈی), wish (باڈی), message (باڈی)۔ دستاویزی ایرر کیسز: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔
تصدیقِ شناخت اور تحفظ
تصدیقِ شناخت ضروری نہیں
Idempotent (دہرانے پر یکساں اثر): نہیں
پیرامیٹرز
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 حروف (اختیاری)مثالی Request
{"name":"علی خان","email":"max@example.com","package":"demo_access"}مثالی Response
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"براہ کرم پہلے اپنے ای میل ایڈریس کی تصدیق کریں۔"}خرابی کے کوڈز
400 VALIDATION_ERROR — ایک لازمی فیلڈ موجود نہیں ہے، یا پیکیج، ادائیگی کا طریقہ یا خواہش غلط ہے۔400 EMAIL_NOT_VERIFIED — ای میل ایڈریس پہلے سے `/email/start-verification` اور `/email/verify` کے ذریعے تصدیق شدہ نہیں ہے، یا `verification_token` موجود نہیں ہے یا غلط ہے۔تصدیق شدہ طرزِ عمل
خالی باڈی 400 `VALIDATION_ERROR` واپس دیتی ہے؛ تصدیق شدہ ای میل ایڈریس کے بغیر درست تفصیلات 400 `EMAIL_NOT_VERIFIED` دیتی ہیں۔ کامیابی کی صورت ای میل کی تصدیق کے بعد دستاویزی عمل کے مطابق ہوتی ہے۔
عوامی فارمز
POST /api/public/contactZentor App ویب سائٹ کے رابطہ فارم سے درخواست وصول کرتا ہے اور اسے Zentor ٹیم کو بھیجتا ہے۔POST /api/public/consultationZentor 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نئے بنائے گئے اکاؤنٹ کو فعال کرتا ہے اور پہلا پاس ورڈ سیٹ کرتا ہے – دعوتی ای میل کے لنک کے ذریعے شروع ہوتا ہے۔