אימות Partner API: מפתחות Bearer מסוג ec_live_, החלפה ושגיאות 401
כל בקשה ל-Partner API נושאת את מפתח הסוד של החשבון בכותרת Authorization: Bearer ec_live_…, ונשלחת מהשרת שלכם. לכל חשבון ב-easyCoexistence יש מפתח אחד, שנוצר בלוח הבקרה תחת Profile ואז Developers, או על ידי כך שמבקשים מעוזר AI להריץ את create_api_key, ומוצג רק פעם אחת. החלפה מנפיקה מפתח חדש ומבטלת את הישן מיד; מפתח חסר או שגוי מקבל 401 unauthorized.
הקידומת שבה מתחיל כל מפתח Partner API, והיא נשלחת בכל בקשה בתור Authorization: Bearer.
מספר המפתחות שחשבון מחזיק בו זמנית; כל חיבור שנוצר בעזרתו שייך לחשבון הזה.
סטטוס למפתח חסר או לא חוקי, עם קוד השגיאה unauthorized והודעה שמציינת את הכותרת הצפויה.
המפתח המלא מוצג פעם אחת, בעת היצירה או ההחלפה; אחר כך נראים רק התווים הראשונים שלו.
איך בקשה מאומתת?
עם המפתח כאסימון Bearer בכותרת Authorization של כל בקשה אל https://easycoexistence.com/api/v1. שום דבר אחר אינו חתום או מוגבל בהרשאות: המפתח מזהה את החשבון, וכל מה שבקשה יוצרת או קוראת שייך לאותו חשבון. גופי הבקשות הם בפורמט ה-JSON, וכל שגיאה חוזרת כאובייקט עם קוד והודעה.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"איפה יוצרים את המפתח?
בלוח הבקרה או מתוך עוזר AI, עם אותה תוצאה. בלוח הבקרה פותחים את Profile, אחר כך את Developers, ולוחצים על Create API key. ב-Claude, ב-ChatGPT או בעוזר אחר שמחובר לשרת MCP של easyCoexistence, מבקשים ממנו להגדיר את ה-Partner API: get_partner_setup מציג מה חסר, ואילו create_api_key מחזיר את המפתח. בשני המקרים המפתח המלא מופיע פעם אחת, ולכן שומרים אותו מיד בסודות של השרת שלכם.
למה המפתח מוצג רק פעם אחת?
כי נשמר רק הגיבוב שלו. easyCoexistence שומר את הגיבוב כדי לבדוק כל בקשה, וגם את התווים הראשונים של המפתח, ec_live_ ועוד שישה, כדי שלוח הבקרה יוכל להציג איזה מפתח פעיל ומתי נוצר. מפתח שאבד אי אפשר להציג שוב; החלפה מחליפה אותו.
איך מחליפים או מבטלים את המפתח?
בשלב אחד, והמפתח הישן מפסיק לפעול באותו רגע, ללא תקופת חסד, שכן דליפה היא הסיבה הנפוצה להחלפה. המפתח החדש מוצג פעם אחת, כמו הראשון:
- לוח הבקרה: Profile, Developers, Rotate key.
- MCP:
create_api_keyעםreplace_existingשערכו true. בלעדיו הכלי מסרב כשמפתח קיים, כך שאינטגרציה שפועלת לא נשברת בטעות. - כדי לעצור את כל הגישה, מבטלים במקום זאת: ביטול (Revoke) בלוח הבקרה, או
revoke_api_keyעם confirm שערכו true. הבקשות נכשלות אז עד שייוצר מפתח חדש.
מה מחזירים מפתח חסר או שגוי?
401 עם הקוד unauthorized, לבקשה שאין בה כותרת Authorization, למפתח שאינו מתחיל ב-ec_live_, או למפתח שהוחלף או בוטל. ההודעה מציינת את הכותרת שהיא מצפה לה. כשבקשות שנכשלו ממשיכות להגיע מכתובת אחת, ה-API עונה במקום זאת 429 rate_limited, עם מספר השניות שיש לחכות לפני ניסיון נוסף.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}במה עוד יכול מפתח תקף להידחות?
מפתח תקף מאמת את החשבון, והמצב של החשבון עדיין חל. אלה חוזרים עם אותו מבנה שגיאה:
- 402
billing_required: אין עדיין כרטיס בחשבון, ולכן לא ניתן לפתוח סשנים של חיבור. - 404
not_found: המזהה אינו שייך לשום חיבור, ערוץ או סשן של החשבון הזה, כולל כאלה בחשבונות אחרים. - 409 removed: החיבור הוסר, ולכן הוובהוק (Webhook) שלו אינו יכול להשתנות.
- 402 suspended: החיבור הושעה אחרי מינוי שפג תוקפו; יש לחבר אותו מחדש קודם.
- 429
cap_reachedאוrate_limited: יותר מדי סשנים פתוחים של חיבור, או יותר מדי שנוצרו בשעה הזאת.
טעויות נפוצות
- שמירת המפתח בצד הלקוח (front-end). כל מי שפותח את הדף יכול לקרוא אותו, ליצור חיבורים שייגבו מכם ולשלוף את האסימונים של הלקוחות שלכם עם ?credentials=1.
- החלפה לפני שהשרת שלכם מסוגל לקבל את המפתח החדש. המפתח הישן מפסיק מיד, ולכן כל בקשה נכשלת ב-401 עד שהחדש נפרס.
- יצירת המפתח בשיחה שמשותפת. create_api_key מחזיר אותו בצ'אט, שם הוא נשאר בהיסטוריה, ולכן יש להחליף אותו אם השיחה שותפה.
- שמירת המפתח בתוך מירכאות. כל מה שאחרי Bearer נקרא כמפתח, ולכן ערך במירכאות לעולם לא תואם, וכל בקשה מקבלת 401.
easyCoexistence מעניק לכל חשבון מפתח Partner API אחד, כך שהשרת שלכם יכול לחבר את מספרי WhatsApp של הלקוחות שלכם ואת חשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, וערוצים נוספים, ואז לקרוא את פרטי ההתחברות של כל חיבור ולנתב את האירועים שלו. US$ 9 עד US$ 0.75 לחיבור לחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם לחשבון יכול להיות יותר ממפתח Partner API אחד?
לא. לחשבון יש מפתח אחד בכל רגע, וייצור של מפתח חדש מחליף אותו. מפתחות נפרדים פירושם חשבונות נפרדים ב-easyCoexistence, לכל אחד חיבורים משלו וחיוב משלו.
האם מפתחות Partner API פוקעים?
לא. המפתח פועל עד שמחליפים או מבטלים אותו, או עד ש-easyCoexistence מבטל אותו בשל שימוש לרעה בכללי Meta.
האם הלקוחות שלי צריכים את המפתח שלי כדי להתחבר?
לא. הם פותחים רק את קישור ההתחברות המאוחסן, שנושא מזהה סשן משלו. המפתח נשאר בשרת שלכם ומשמש את הקצה האחורי שלכם בלבד.
האם מפתח ה-API זהה לסוד החתימה של האירועים?
לא. המפתח מאמת את הבקשות שלכם אל ה-API. סוד החתימה, שמוצג פעם אחת כשמגדירים את כתובת ה-URL לאירועי הסטטוס, מאפשר לנקודת הקצה שלכם לאמת את האירועים ש-easyCoexistence שולח.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-