מפתח שפותח בדיוק את מה שהגדרתם לו, ולא יותר
רוב התוכנות העסקיות מתייחסות ל-API שלהן כפתח יציאה — דרך להוציא נתונים, שהוברגה מאוחר ומתועדת ב-PDF. אצלנו זו אותה מערכת הרשאות שהאפליקציה עצמה משתמשת בה, כלומר מפתח לעולם לא יכול לעשות דבר שהאדם שיצר אותו לא יכול, ואתם רואים בדיוק מה מותר לו עוד לפני שאתם מוסרים אותו לספק.
למפתח יש היקף, וההיקף אמיתי
יוצרים מפתח בהגדרות, בוחרים את ההרשאות המוגדרות שמותר לו להשתמש בהן, ורואים את הסוד פעם אחת בלבד. מה שהמפתח יכול לעשות הוא החיתוך בין ההיקפים האלה לבין מה שליוצר שלו כבר היה מותר — כלומר הוא מצמצם, לעולם לא מרחיב.
- ההיקפים נבחרים מאותה רשימת הרשאות שמנהלת אנשים
- מפתח לעולם לא יורש עקיפה של מנהל, מי שלא יצר אותו
- אפשר לקבוע תפוגה, לבטל בכל רגע, ולראות מתי מפתח שימש לאחרונה
מפרט, לא רשימת נקודות קצה במייל
מסמך OpenAPI מתאר את המשטח, כך שאפשר לייצר לקוח במקום לכתוב בקשות ביד. שולחים את המפתח בכותרת X-Api-Key או כאסימון נושא — מה שפלטפורמת האינטגרציה שלכם מכירה באופן טבעי.
- מפרט OpenAPI (Swagger), מגורסה יחד עם ה-API
- X-Api-Key או Authorization: Bearer — שניהם מתקבלים
- שגיאות חוזרות כמעטפות עם קוד, לא כטקסט שצריך לנתח
ונקודת קצה MCP, כדי שעוזר יוכל לקרוא את המערכת החיה
נפרד מה-API ומעניין יותר: חיבור MCP מאפשר לעוזר AI — Claude, ChatGPT, מה שאתם משתמשים בו — לתשאל את המערכת החיה בשפה פשוטה, במקום לשמוע עליה מכלי שני. הוא קורא תחת הרשאה משלו, דרך אותן בדיקות הרשאות ומודולים כמו אדם, וכל קריאה נרשמת ביומן הביקורת.
- חיבורים מנוהלים בהגדרות: מוגבלי היקף, מוצגים פעם אחת, ניתנים לביטול
- העוזר כפוף לאותן הרשאות ומודולים כמו כולם
- הוא יכול לקרוא, והוא יכול להציע שינוי — אבל רק אדם יכול לבצע אותו
על מה API ואינטגרציות רץ
אפשר להחזיק את זה לבד, או להוסיף מודולים לצידו כשתרצו — הם חולקים התחברות אחת ומערכת רשומות אחת. ראו את ספריית המודולים ואת המחירים.
- כלול בחשבון — אין מודול API לקנות
- CRM
- מלאי
- שירות שטח
- כספים
שאלות שקונים שואלים
מה מפתח API באמת יכול להגיע אליו?
נקודות קצה שמצהירות על הרשאה, ורק אלה שהמפתח שלכם מוגדר עבורן. זה צר יותר בכוונה מ"כל מה שהמשתמש יכול": אם מפתח היה יכול לקרוא לנקודות קצה בלי הרשאה מוצמדת, ההיקפים שבחרתם היו דקורטיביים. זה גם אומר שהמשטח גדל בהחלטה מכוונת ולא במקרה, אז שאלו אותנו אם משהו שאתם צריכים עדיין לא מכוסה.
מה קורה אם מפתח דולף?
מבטלים אותו — המפתח מפסיק לעבוד מיד, וממילא מעולם לא היה יכול לעשות יותר ממה שההיקפים שלו איפשרו. אפשר גם לקבוע למפתח תאריך תפוגה, ומפתח לעולם לא יכול לשמש ליצירה או ביטול של מפתחות, כך שמפתח שדלף לא יכול להנפיק לעצמו מחליף או להסתתר על ידי מחיקת אחרים.
האם עוזר AI יכול לשנות דברים במערכת שלי?
לא בכוחות עצמו, וזה התכנון ולא פער. קריאות רצות ונרשמות ביומן הביקורת. כתיבה לעולם לא מבוצעת על ידי העוזר: שכבת היכולות מסרבת להריץ אותה ורושמת אותה כהצעה, ואדם מאשר או דוחה אותה בתור ההכרעות. אישור מריץ מחדש את הפעולה תחת הזהות שעבורה ה-AI פעל, ורק אם למאשר יש ההרשאה שאותה כתיבה הייתה דורשת מאדם שעושה אותה בעצמו. כלומר עוזר יכול לבקש שינוי; רק אדם יכול לבצע אותו. נוסף על כך, נקודת הקצה של MCP יושבת מאחורי מתג ה-AI בהגדרות שלכם: כבוי עד שתדליקו אותו.
יש סביבת בדיקות, webhooks, או מגבלת קצב שכדאי לתכנן סביבה?
אין דייר בדיקות, אין webhooks יוצאים ואין מגבלת קצב מפורסמת היום — ואנחנו מעדיפים לומר זאת מפורשות מאשר לתת ל"יש לנו API" לרמוז עליהם. אינטגרציות מתשאלות במקום להירשם לעדכונים. אם webhooks הם מה שהאינטגרציה שלכם צריכה, אמרו לנו: זו שיחת בנייה ולא הגדרה מוסתרת.
יש ספריות לקוח?
לא כתובות ביד. יש מפרט OpenAPI, וייצור לקוח ממנו בשפה שלכם הוא שלב רגיל ברוב הסביבות. אנחנו מעדיפים לשחרר מפרט מדויק מאשר שלוש ערכות SDK שנסחפות זו מזו.
לראות את זה עובד
פתחו חשבון, או ספרו לנו איך אתם עובדים היום ונראה לכם איך API ואינטגרציות נראה על הנתונים שלכם.