اس فہرست کے بارے میں
جہاں بیشتر API دستاویزات میں غلطی ہوتی ہے
بہت سے رہنما خطوط اینڈ پوائنٹس کی فہرست تو دیتے ہیں لیکن ان تفصیلات کو چھوڑ دیتے ہیں جو درحقیقت الجھن کا باعث بنتی ہیں: عملی طور پر تصدیق کی توثیق (authentication) کیسے کام کرتی ہے، درخواست اور جواب کی درست مثالیں، اور مخصوص غلطیوں کے معنی کیا ہیں اور انہیں کیسے حل کیا جائے۔ جب ایسا ہوتا ہے تو ڈویلپرز سپورٹ ٹکٹ درج کروانے پر مجبور ہوتے ہیں، جو دستاویزات رکھنے کے مقصد کو ہی فوت کر دیتا ہے۔
ہمارا طریقہ کار
ہم قیاس آرائیوں پر انحصار کرنے کے بجائے براہ راست آپ کے سورس کوڈ سے تعمیر کرتے ہیں۔ ہم لائیو اسناد کا استعمال کرتے ہوئے خود API کی جانچ کرنے سے پہلے آپ کے روٹس، توثیقی منطق، اور خرابی سے نمٹنے کے نظام کا معائنہ کرتے ہیں۔ حتمی دستاویزات میں ہر مثال ایک حقیقی درخواست کی نمائندگی کرتی ہے جو ہم نے بھیجی اور وہ جواب جو ہمیں موصول ہوا، جس سے بناوٹی تفصیلات یا ناممکن اسٹیٹس کوڈز کی عدم موجودگی یقینی بنتی ہے۔
آپ کیا حاصل کرتے ہیں
- تصدیق کی توثیق کے بارے میں رہنمائی: ٹوکن کا اجرا، تجدید، اور اگر سیشن کے دوران اس کی میعاد ختم ہو جائے تو کیا ہوتا ہے۔
- ہر اینڈ پوائنٹ کی مکمل معلومات، بشمول پیرامیٹرز، کام کرنے والی ایک مثالی درخواست، اور حقیقی جواب کی ساخت۔
- غلطیوں کا حوالہ جو ہر کوڈ کو اس کی وجہ اور حل سے جوڑتا ہے، نہ کہ صرف پیغام کا اعادہ۔
- ایک فوری شروعات کا راستہ جو کسی نئے ڈویلپر کو صفر سے کامیاب کال تک لے جانے کے لیے تیار کیا گیا ہے۔
- جہاں بھی متعلقہ ہوں ریٹ کی حدود، صفحہ بندی، ویب ہکس، اور آئیڈیمپوٹینسی کے بارے میں نوٹس۔
ترسیل کا فارمیٹ
ہم آپ کے ریپوزیٹری کے لیے موزوں Markdown فراہم کرتے ہیں، جو اس طرح ترتیب دیا گیا ہے کہ یہ OpenAPI یا دستاویزات کی ویب سائٹ کے مطابق ہو، جسے بھی آپ کی ٹیم اپ ڈیٹ رکھنا چاہے۔ کوڈ کے نمونے ان زبانوں میں فراہم کیے جاتے ہیں جن پر آپ کے صارفین انحصار کرتے ہیں اور انہیں چلا کر ٹیسٹ کیا جاتا ہے۔ درخواست پر Postman طرز کا مجموعہ شامل کیا جا سکتا ہے۔
ہمیں آپ سے کس چیز کی ضرورت ہے
آپ کے ریپوزیٹری یا OpenAPI فائل تک رسائی، ٹیسٹ کے ماحول کے لیے فعال اسناد، اور وہ سوالات جن کے جوابات آپ کا سپورٹ عملہ اکثر دیتا ہے - یہ گائیڈ کے ڈھانچے کو تشکیل دیتے ہیں۔
کیا شامل نہیں ہے
یہ سروس سافٹ ویئر کے طرز عمل کی قطعی تکنیکی دستاویزات کا احاطہ کرتی ہے؛ پروموشنل یا مارکیٹنگ کا مواد ایک الگ کام ہے۔
عمل اور اوقات کار
آپ کو ایک مکمل پہلا مسودہ موصول ہوگا، جسے آپ ان بار بار پوچھے جانے والے سوالات کے خلاف چیک کر سکتے ہیں جن کا آپ کی سپورٹ ٹیم جواب دیتی ہے۔ ہم ترجیح دیں گے کہ کوئی انجینئر کسی غیر معمولی صورت حال کی جلد نشاندہی کر لے، بجائے اس کے کہ ہم کوئی ایسی چیز پیش کریں جو بظاہر شاندار ہو لیکن غیر درست ہو۔ چونکہ ہر مثال کو آپ کے لائیو API پر چلا کر دیکھا گیا ہے، اس لیے حتمی دستاویز میں کوئی بھی چیز نظریاتی نہیں ہے۔
یہ پیکیج مقررہ قیمت پر ایک API دستاویزات کے دائرہ کار کا احاطہ کرتا ہے جو ایک ہی بار میں، ایک دور کے نظرثانی کے ساتھ، 500.99 USD میں اور 10 دن کے اندر مکمل کیا جاتا ہے۔ آپ کو وہ ڈومین فراہم کرنا ہوگا جس سے آرڈر متعلق ہے اور اپنی مختصر ہدایات فراہم کرنی ہوں گی۔