**גרסאות API** · [V2 (Latest)](/integrations/v2/docs?lang=he) · **V1**

> **גרסה זו של ה־API מיושנת.** לחיבורים חדשים יש להשתמש בגרסה העדכנית ביותר. [לתיעוד העדכני](/integrations/v2/docs?lang=he)

# אימות

מפתח אחד, תחום גישה מוגדר והרשאות מפורשות.

שלחו את המפתח בכותרת Authorization: Bearer או X-API-Key. לעולם אל תכללו אותו בכתובת URL או בקוד ציבורי של אתר.

```shell
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEY
```

המפתח ke_live_ משויך לארגון אחד בלבד. הרשאות קריאה, כתיבה ושליחה נפרדות זו מזו. בכל פעולה מצוינות ההרשאות שהיא מקבלת.

## הבנת שגיאה

401 MISSING_API_KEY או INVALID_API_KEY: בדקו את המפתח, הכותרת והסביבה. 403 INSUFFICIENT_SCOPE: בדקו את ההרשאות הנדרשות לפעולה.

שגיאות עסקיות אחרות מתועדות לכל פעולה בנפרד. שמרו את קוד ה-HTTP ואת השדה error כדי לאבחן כשל.

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