> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# מדריך שגיאות

> כל השגיאות שה-API הציבורי /v1 של Living Security עשוי להחזיר, לרבות קוד המכונה היציב שלהן, סטטוס ה-HTTP, ואופן הפתרון.

כל תגובת שגיאה של `/v1` היא `application/problem+json` ‏([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)) עם קבוצת שדות קבועה:

```json theme={null}
{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No such organization.",
  "code": "resource_not_found",
  "request_id": "req_...",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "retryable": false
}
```

יש לבצע הסתעפות לוגית על סמך `code` ולא על סמך `detail` — `code` הוא חוזה יציב לקריאה אוטומטית; `detail` מיועד לקריאה אנושית ועשוי להשתנות. `param` מופיע כאשר ניתן לייחס את השגיאה לפרמטר מסוים בבקשה. יש לצרף את `request_id` בעת פנייה לתמיכה.

## קודי שגיאה

| קוד | סטטוס HTTP | ניתן לנסות שוב |
| - | - | - |
| [`unauthorized`](/he/developers/v1/errors/unauthorized) | 401 | לא |
| [`credential_inactive`](/he/developers/v1/errors/credential_inactive) | 401 | לא |
| [`credential_expired`](/he/developers/v1/errors/credential_expired) | 401 | לא |
| [`credential_revoked`](/he/developers/v1/errors/credential_revoked) | 401 | לא |
| [`not_entitled`](/he/developers/v1/errors/not_entitled) | 403 | לא |
| [`insufficient_permission`](/he/developers/v1/errors/insufficient_permission) | 403 | לא |
| [`permission_denied`](/he/developers/v1/errors/permission_denied) | 403 | לא |
| [`resource_not_found`](/he/developers/v1/errors/resource_not_found) | 404 | לא |
| [`invalid_request`](/he/developers/v1/errors/invalid_request) | 400 או 409 | לא |
| [`invalid_filter`](/he/developers/v1/errors/invalid_filter) | 400 | לא |
| [`unsupported_version`](/he/developers/v1/errors/unsupported_version) | 400 | לא |
| [`idempotency_key_reuse`](/he/developers/v1/errors/idempotency_key_reuse) | 409 | תלוי בקונפליקט |
| [`rate_limited`](/he/developers/v1/errors/rate_limited) | 429 | כן |
| [`service_unavailable`](/he/developers/v1/errors/service_unavailable) | 503 | כן |
| [`internal_error`](/he/developers/v1/errors/internal_error) | 500 | כן |

קבוצת הקודים סגורה: הוספת קודים חדשים היא שינוי בחוזה הציבורי ותוכרז באמצעות יומן השינויים של ה-API. תגובת `retryable: true` מציינת שייתכן שהמצב ייפתר מעצמו; היא אינה מוכיחה שפעולת כתיבה לא הייתה בעלת השפעה. יש לנסות שוב פעולות קריאה במסגרת תקציב מוגבל של ניסיונות וזמן, תוך שימוש בהשהיה מעריכית (exponential backoff) וב-jitter. יש לכבד את `Retry-After` כאשר הוא קיים, לרבות בתגובת `409` או `429` שניתן לנסות שוב.

בפעולות שינוי, יש לפעול בהתאם לחוזה האידמפוטנטיות וההתאוששות המתועד של הפעולה. יש לשמור את המפתח המקורי ואת הבקשה המקורית כאשר הדבר נתמך. אין ליצור מפתח חדש לאחר פקיעת זמן או `5xx`: פעולה זו עלולה לחזור על כתיבה שהצליחה. כותרת `Idempotency-Key` אינה מספקת הגנה בפעולה שאינה תומכת בה.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.