# שגיאות ומגבלות קצב בקשות

שגיאות KolWrite API מוחזרות בתגובות JSON עם `code` יציב בכל מקרה שבו
הלקוח יכול לפעול.

```json
{
  "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` או שגיאות תיקוף עד
לתיקון האסימון או הבקשה.