API کی غلطیوں اور دوبارہ کوششوں کو ہینڈل کریں
ShareAI تصدیق، دائرہ کار، ماڈل رسائی اور دستیابی کی غلطیوں کی تشخیص کریں بغیر نقل تحریروں یا غیر محفوظ ریفریش ری ٹرائیز کے۔
اس صفحے پر
ہمیشہ HTTP اسٹیٹس کا معائنہ کریں اس سے پہلے کہ کسی جواب کو کامیابی کے طور پر پڑھیں۔ ShareAI سروسز مختلف غلطی کے لفافے واپس کر سکتی ہیں: انفرنس فراہم کر سکتا ہے error.code، OAuth فراہم کرتا ہے error اور error_description، اور کنسول روٹس واپس کر سکتے ہیں code, message اور data.status.
| حیثیت | عام مطلب | بحالی |
|---|---|---|
| 200 کے ساتھ ایک غلطی آبجیکٹ | موجودہ چیٹ اینڈ پوائنٹ میں کوئی ڈیوائس دستیابی کا نتیجہ نہیں۔ | error.code کا معائنہ کریں اور اسے اسسٹنٹ کے جواب کے طور پر ظاہر نہ کریں۔ |
| 400 | غلط درخواست یا OAuth گرانٹ۔ | باڈی، پیرامیٹرز، کال بیک یا ختم شدہ/استعمال شدہ کوڈ کو درست کریں۔ |
| 401 | گمشدہ، ختم شدہ یا غیر درست تصدیق۔ | اسناد چیک کریں؛ صرف ایک درست OAuth گرانٹ کو ریفریش کریں۔ |
| 402 | ناکافی کریڈٹس یا قابل اطلاق بیلنس۔ | دوبارہ کوشش کرنے سے پہلے منتخب کردہ اکاؤنٹ کا بیلنس چیک کریں۔ |
| 403 | دائرہ کار، ملکیت، کردار یا فعال حالت کی تردید۔ | دستاویزی اجازت کی حد کو چیک کریں۔ |
| 404 | نامعلوم وسیلہ یا غیر معاون گیٹ وے راستہ۔ | میزبان، راستہ اور وسیلہ شناخت کنندگان کو چیک کریں۔ |
| 409 | حالت یا نظرثانی تنازعہ۔ | موجودہ حالت پڑھیں اور تبدیلی پر دوبارہ غور کریں۔ |
| 429 | درخواست یا ہم وقتی حد۔ | Retry-After کا احترام کریں اور محدود بیک آف استعمال کریں۔ |
| 500 / 502 / 503 | سرور یا اپ اسٹریم دستیابی کی ناکامی۔ | دوبارہ کوششوں کو محدود رکھیں؛ تشخیصی شناخت کنندگان کو محفوظ رکھیں۔ |
ایک حد کے ساتھ پڑھائی کو دوبارہ آزمائیں#
پڑھنے پر عارضی ناکامیوں کے لیے، بڑھتی ہوئی تاخیر اور جِٹر کے ساتھ انتظار کریں، Retry-After کا احترام کریں جب موجود ہو اور ایک مقررہ کوشش یا وقت کے بجٹ کے بعد رک جائیں۔ جب ڈیٹا دستیاب نہ ہو تو صارف کو دکھائیں بجائے اس کے کہ خاموشی سے لوپ کریں۔
تحریروں کو احتیاط سے سنبھالیں#
قیمت کی تازہ کاری، ماڈل تخلیق یا شیئرنگ کمانڈ کو خودکار طور پر دوبارہ نہ دہرائیں جب نتیجہ نامعلوم ہو۔ پہلے وسیلہ یا کمانڈ کی حالت پڑھیں۔ Idempotency-Key صرف ان اینڈ پوائنٹس پر استعمال کریں جو دستاویزی حمایت رکھتے ہوں، جیسے معاہدے کی تبدیلیاں۔
ریفریش ٹوکن ایک بار استعمال کے لیے ہیں#
ریفریش روٹیشن کو آپ کے بیک اینڈ میں فی اجازت لاک کی ضرورت ہوتی ہے۔ ایک استعمال شدہ ریفریش ٹوکن کی اندھی دوبارہ کوشش گرانٹ کو منسوخ کر سکتی ہے۔ دیکھیں محفوظ ٹوکن ریفریش.
سپورٹ درخواست میں کیا شامل کریں#
جب دستیاب ہو تو اینڈ پوائنٹ، HTTP اسٹیٹس، ایرر کوڈ، وقت اور جواب/ٹاسک شناخت کنندہ شامل کریں۔ Authorization ہیڈرز، کوکیز، کلائنٹ سیکریٹس، ایکسیس ٹوکنز، ریفریش ٹوکنز اور نجی پرامپٹ مواد کو ہٹا دیں۔
آخری بار اپ ڈیٹ کیا گیا ستمبر 15, 2026