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 کی API کے گروپ “عوامی فارمز” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: email (باڈی)۔ دستاویزی ایرر کیسز: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

فی IP ایڈریس ہر 15 منٹ میں زیادہ سے زیادہ 10 درخواستیں۔ اس کے علاوہ Zentor کے رسائی قواعد (IP، ملک اور ای میل ڈومین قواعد) بھی لاگو ہوتے ہیں؛ مسترد کالز کو 403 ملتا ہے۔

ریٹ لمٹ: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent (دہرانے پر یکساں اثر): نہیں

پیرامیٹرز

email(body, string، ضروری)— ای میل ایڈریس جس کی تصدیق کی جانی ہے

مثالی Request

{"email":"max@example.com"}

مثالی Response

{"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/contactZentor App ویب سائٹ کے رابطہ فارم سے درخواست وصول کرتا ہے اور اسے Zentor ٹیم کو بھیجتا ہے۔POST /api/public/consultationZentor App ویب سائٹ کے فارم سے مشاورتی درخواست وصول کرتا ہے۔POST /api/public/access-requestکسی پیکیج (Starter، انفرادی یا 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نئے بنائے گئے اکاؤنٹ کو فعال کرتا ہے اور پہلا پاس ورڈ سیٹ کرتا ہے – دعوتی ای میل کے لنک کے ذریعے شروع ہوتا ہے۔

متعلقہ مضامین

← عوامی فارمز