שגיאות ומגבלות קצב בקשות
שגיאות KolWrite API מוחזרות בתגובות JSON עם code יציב בכל מקרה שבו הלקוח יכול לפעול.
{
"detail": {
"code": "insufficient_scope",
"message": "This endpoint requires the 'jobs:write' scope",
"required_scope": "jobs:write"
}
}סטטוסים נפוצים
| סטטוס | משמעות |
|---|---|
400 | קלט לא תקין או שילוב אפשרויות שאינו נתמך |
401 | אסימון חסר, לא תקין, שפג תוקפו או שבוטל |
403 | האסימון תקין, אך חסר לו היקף ההרשאה הנדרש או שאין לו גישה לנתיב |
404 | המשאב חסר או אינו גלוי לבעלי האסימון |
409 | התנגשות, בדרך כלל עקב בעיית אידמפוטנטיות או מעבר מצב |
422 | מבנה גוף הבקשה הוא JSON תקין, אך אינו עובר תיקוף |
429 | חריגה ממגבלת קצב הבקשות או עומס בהקצאת יחידות שימוש |
5xx | שגיאה זמנית בשירות KolWrite |
הנחיות לניסיונות חוזרים
נסו שוב לאחר 429, 502, 503 ו-504 עם השהיה מעריכית ומרווח אקראי. השתמשו ב-Idempotency-Key בעת יצירת משימה כדי שניסיונות חוזרים ברשת לעולם לא ייצרו משימות כפולות. אל תנסו שוב לאחר 401, 403 או שגיאות תיקוף עד לתיקון האסימון או הבקשה.