حدود اور غلطیاں

ہر صفحہ کو پڑھیں، شرح کی حدود کا احترام کریں اور غلطیوں سے محفوظ طریقے سے بازیافت کریں۔

1. شرح کی حد

   حدود قابل ترتیب ہیں۔ GET /v1/operations/capabilities requestsPerMinute اور authenticationRequestsPerMinutePerIp کی رپورٹ کرتا ہے۔ 429 کے بعد، Retry-After کا احترام کریں اور اگر تھروٹلنگ جاری رہتی ہے تو زیادہ انتظار کریں۔ بیچ ریڈز 100 IDs تک قبول کرتے ہیں۔ انفرادی اختتامی پوائنٹس میں چھوٹا صفحہ یا پے لوڈ کی حدیں ہو سکتی ہیں۔

2. ہر صفحہ پڑھیں

   اسی فلٹرز کو برقرار رکھتے ہوئے آپ نے جس اختتامی نقطہ کو کال کیا ہے اس کے لیے تسلسل کے اصول کا استعمال کریں۔ جب آپ انہیں پڑھتے ہیں تو فہرستیں بدل سکتی ہیں۔ جب آپ کو مستقل کاپی کی ضرورت ہو تو سنیپ شاٹس استعمال کریں۔

   صفحہ بندی	کے ساتھ جاری رکھیں	جب روکو
   کرسر	next کو after کے بطور پاس کریں۔	اگلا null ہے۔
   nextOffset کے ساتھ آفسیٹ	nextOffset کو offset کے بطور پاس کریں۔	nextOffset null ہے۔
   hasMore کے ساتھ آفسیٹ	لوٹائی گئی اشیاء کی تعداد کے حساب سے آفسیٹ میں اضافہ کریں۔	hasMore غلط ہے۔
   سافٹ ویئر	عددی next قدر کو after کے طور پر پاس کریں؛ updatedAtUtc تبدیل ہونے پر دوبارہ شروع کریں۔	اگلا null ہے۔
   ایونٹ فیڈ	next کو after کے بطور پاس کریں۔	hasMore غلط ہے۔

3. غلطیوں کو ہینڈل کریں۔

   غلطی کوڈ کے ساتھ ساتھ HTTP کی حیثیت کو بھی پڑھیں۔ اگر جواب میں requestId شامل ہے، تو سپورٹ سے رابطہ کرتے وقت اس کا حوالہ دیں۔

   HTTP کی حیثیت	کیا کرنا ہے
   400	درخواست کو درست کریں۔
   401	اسناد چیک کریں یا نیا رسائی ٹوکن حاصل کریں۔
   403	دائرہ کار، اجازتیں اور رسائی کو چالو کیا گیا ہے چیک کریں۔
   404	وسائل غائب یا آپ کے دائرہ کار سے باہر ہوسکتے ہیں۔
   409	فیصلہ کرنے سے پہلے ایرر کوڈ اور موجودہ حالت کو پڑھیں۔
   410	اسنیپ شاٹ یا ایونٹ کرسر کی میعاد ختم ہو گئی۔ ایک نئی بیس لائن شروع کریں۔

4. اگر لکھنے کا وقت ختم ہو جائے۔

   ٹائم آؤٹ یا 503 یہ ثابت نہیں کرتا کہ کارروائی ناکام ہو گئی۔ ان تحریروں کے لیے جو آپریشن کی رسیدیں واپس کریں، دوبارہ کوشش کرنے سے پہلے GET /v1/operations/by-key?idempotencyKey={key} تلاش کریں۔ دیکھ بھال کی تخلیق کے لیے، اصل Idempotency-Key اور باڈی کو دوبارہ استعمال کریں۔