מגבלות ושגיאות

קרא כל עמוד, כבד את מגבלות הקצב והתאושש בבטחה משגיאות.

1. מגבלות קצב

   ניתן להגדיר את המגבלות. GET /v1/operations/capabilities מדווח על requestsPerMinute ו-authenticationRequestsPerMinutePerIp. לאחר 429, כבד את Retry-After והמתן זמן רב יותר אם הוויסות נמשך. קריאות אצווה מקבלות עד 100 מזהים; נקודות קצה בודדות עשויות להיות בעלות מגבלות עמוד או מטען קטנות יותר.

2. תקרא כל עמוד

   השתמש בכלל ההמשך עבור נקודת הקצה שאליה קראת, תוך שמירה על אותם מסננים. רשימות יכולות להשתנות בזמן הקריאה; השתמש בתמונות כאשר אתה זקוק לעותק עקבי.

   עמודים	המשך עם	עצור כאשר
   סמן	העביר את next כ-after.	הבא בתור הוא null.
   היסט עם nextOffset	העביר את nextOffset כ-offset.	nextOffset הוא null.
   קיזוז עם hasMore	הגדל את הקיזוז במספר הפריטים המוחזרים.	hasMore הוא false.
   תוכנה	העבירו את הערך המספרי next כ-after; הפעילו מחדש אם updatedAtUtc משתנה.	הבא בתור הוא null.
   הזנת אירועים	העביר את next כ-after.	hasMore הוא false.

3. טיפול בשגיאות

   קראו את קוד השגיאה וכן את סטטוס ה-HTTP. אם התגובה כוללת את requestId, צטטו אותו בעת פנייה לתמיכה.

   סטטוס HTTP	מה לעשות
   400	תקן את הבקשה.
   401	בדוק את האישורים או קבל אסימון גישה חדש.
   403	בדוק את ההיקף, ההרשאות והאם הגישה מופעלת.
   404	ייתכן שהמשאב חסר או מחוץ לתחום שלך.
   409	קרא את קוד השגיאה ואת המצב הנוכחי לפני קבלת החלטה.
   410	תמונת המצב או סמן האירוע פג תוקפו. התחל בסיס חדש.

4. אם כתיבה נגמרת

   פסק זמן או 503 אינם מוכיחים שהפעולה נכשלה. עבור כתיבות המחזירות קבלות פעולה, חפש את GET /v1/operations/by-key?idempotencyKey={key} לפני ניסיון חוזר. ליצירת תחזוקה, השתמש שוב ב-Idempotency-Key ובגוף המקוריים.