אימות (Authentication)
חלק מקריאות ה-API דורשות Bearer Token בכותרת ה-HTTP. כאן מוסבר מאיפה משיגים את הטוקן, אילו קריאות דורשות אותו, ואילו חבילות נדרשות.
חלק מקריאות ה-API דורשות Bearer Token בכותרת ה-HTTP:
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/jsonמאיפה משיגים את הטוקן
בהגדרות → API בתוך המערכת. לחיצה על אייקון העין חושפת את המפתח - העתיקו אותו.
אילו קריאות דורשות אימות
| Endpoint | נדרש אימות? |
|---|---|
AddLead | ברירת מחדל לא - אך ניתן להפעיל חיוב Bearer Token בהגדרות |
UpdateLead | כן - Bearer Token |
GetLeadId | כן - Bearer Token |
GetLeadIds | כן - Bearer Token + חבילת Premium/Pro |
GetStatus | כן - Bearer Token |
GetFields / GetUsers | כן - Bearer Token |
AddMeeting / AddTask / AddPurchase / AddRecurring / AddSale | ברירת מחדל לא - אך ניתן להפעיל חיוב Bearer Token בהגדרות (הגדרה אחת משותפת לכולם) |
AddWhatsappToSend / GetWhatsappMessages | כן - Bearer Token תמיד (חובה) |
קריאה/עדכון משימות - GetTasks / GetTask / UpdateTask | כן - Bearer Token תמיד (חובה) |
פגישות - UpdateMeeting / CancelMeeting | כן - Bearer Token תמיד (חובה) |
רכישות - GetPurchases / GetPurchase / UpdatePurchaseStatus | כן - Bearer Token תמיד (חובה) |
הוראות קבע - GetRecurring / UpdateRecurring | כן - Bearer Token תמיד (חובה) |
פרויקטים - AddProject / GetProject / UpdateProject | כן - Bearer Token תמיד (חובה) |
חבילה נדרשת
GetLeadIds (שליפת רשימת לידים) זמין בחבילת Premium / Pro. אם החבילה לא כוללת גישה ל-API, התשובה תהיה PLAN_UPGRADE_REQUIRED. GetLeadId (ליד בודד) ו-GetStatus זמינים בכל חבילה עם טוקן תקין.
קודי שגיאת אימות
| קוד | משמעות |
|---|---|
TOKEN_MISSING | לא נשלחה כותרת Authorization |
TOKEN_INVALID | הטוקן שגוי או לא תקין |
TOKEN_NOT_CONFIGURED | לא הוגדר טוקן בחשבון |
PLAN_UPGRADE_REQUIRED | החבילה לא כוללת גישה ל-API לשליפת רשימה |