יוצרים מפתח לאינטגרציה, מעתיקים אותו בפעם היחידה שהוא מוצג, ומבטלים אותו כשכבר לא צריך.
מפתח API מאפשר למערכת שאתם או המפתח שלכם בניתם לדבר עם חשבון Fine Structure בלי הסיסמה שלכם. המפתחות נמצאים בעמוד מפתחות API: פותחים את תפריט החשבון, אחר כך מפתחים, ואז מפתחות API, או נכנסים ל-/api-keys. אם רוצים שכלי AI כמו Claude או Cursor יעבוד על האפליקציות, צריך טוקן MCP, עם הרשאות משלו: ראו חיבור כלי AI.
1. לוחצים על מפתח חדש: בראש העמוד לוחצים + מפתח חדש. נפתחת תיבה בשם יצירת מפתח API חדש. נותנים למפתח שם שאומר איפה הוא משמש, למשל "סנכרון הזמנות" או "Production". מפתח בלי שם נשמר בשם Default.
2. לוחצים על יצירת מפתח: מופיעה תיבה ירוקה: מפתח ה-API החדש (מוצג פעם אחת בלבד). לוחצים העתקה ומדביקים את המפתח במערכת שצריכה אותו, או במנהל הסיסמאות. בסיום לוחצים סגירה.
3. מבטלים מפתח שכבר לא בשימוש: כל מפתח מופיע תחת מפתחות ה-API שלי עם השם שלו, התווים הראשונים של המפתח ותאריך היצירה. לוחצים ביטול המפתח ומאשרים. המפתח מפסיק לעבוד ונשאר ברשימה עם התווית בוטל.
המפתח מוצג פעם אחת: Fine Structure שומרת רק טביעת אצבע של המפתח, לא את המפתח עצמו, ולכן אף אחד לא יכול להציג לכם אותו שוב. אם הוא אבד, מבטלים אותו ויוצרים חדש.
התיבה שימוש ב-API בתחתית העמוד מציגה את הפורמט. המפתח נשלח בכותרת Authorization של כל בקשה, ורק מהשרת. לא שמים אותו בעמוד אינטרנט, בחלק הגלוי של אפליקציה או במאגר קוד ציבורי.
Authorization: Bearer fse2_your_api_key_here
מילה | מה היא אומרת
API | הדרך שבה מערכת ממוחשבת אחת מדברת עם אחרת, בלי שאדם לוחץ על כפתורים.
מפתח API | סיסמה ארוכה שנועדה למערכת ולא לאדם. מי שמחזיק בה יכול לפעול בשם החשבון, ולכן שומרים עליה כמו על הקוד הסודי של הכרטיס בבנק.
כותרת (Header) | שורת מידע נסתרת שנשלחת עם כל בקשה, לפני התוכן.
כותרת Authorization | הכותרת שנושאת את המפתח. הערך שלה הוא המילה Bearer, רווח, והמפתח.
רק מהשרת | המפתח נשמר במחשב שבשליטתכם (השרת של המפתח שלכם, או כלי אוטומציה כמו Make). אף פעם לא בתוך עמוד אינטרנט או אפליקציה שרצה בטלפון של המבקר, שם כל אחד יכול לקרוא אותו.
בכלי אוטומציה יש לבקשה בדרך כלל מקום לכותרות עם שתי תיבות. ממלאים אותן כך:
Name: Authorization Value: Bearer fse2_your_api_key_here
לאיזו כתובת הבקשה נשלחת ומה היא שולחת נקבע לפי החיבור שבונים. אם לא בטוחים, מעבירים את העמוד הזה למפתח שלכם. לעבודות הנפוצות יש כלי מוכן: ראו בטבלה למטה.
מה רוצים | במה משתמשים
לתת ל-Claude, ל-Cursor או לכלי AI אחר לבנות ולערוך את האפליקציות | טוקן MCP
לתת ל-CRM ליצור חוזים ולקרוא חוזים חתומים | מפתח API של חוזים
לשמור סיסמה או מפתח שהאפליקציות והסוכנים משתמשים בהם | סוד גלובלי
לקבל עדכון כשסוכן כותב הודעה | webhook לסוכנים
שהאתר ישלח קבצים למוח העסקי | webhook של מחברת
Q: סגרתי את התיבה לפני שהעתקתי. אפשר לראות את המפתח שוב?
A: לא. מבטלים אותו ויוצרים חדש.
Q: ביטול מוחק את המפתח?
A: הוא מפסיק לעבוד מיד. הוא נשאר ברשימה עם התווית בוטל, כדי שיהיה ברור אילו מפתחות היו.
Q: כמה מפתחות אפשר ליצור?
A: עדיף מפתח לכל מערכת. כך אפשר לבטל אחד בלי לשבור את האחרים.
Q: מה קורה למפתחות אם מוחקים את החשבון?
A: כולם מבוטלים כחלק ממחיקת החשבון.
Q: המערכת שחיברתי אומרת שהמפתח לא מתקבל.
A: בודקים שלושה דברים: הערך מתחיל ב-Bearer ורווח אחד, המפתח הועתק במלואו, והשורה שלו לא מסומנת בוטל. אם שלושתם בסדר, ייתכן שהכתובת שפונים אליה לא מקבלת מפתחות חשבון; שואלים את המפתח שלכם, או משתמשים בכלי מהטבלה למעלה שמתאים לעבודה.
Q: אפשר לשים את המפתח באפליקציה כדי שיעבוד בדפדפן?
A: לא. כל מה שנמצא בתוך עמוד אינטרנט, כל מבקר יכול לקרוא. שומרים מפתחות בסודות ומשתמשים בהם מפונקציית שרת.
Related: Connect AI tools: Claude, ChatGPT, Cursor and more, Global secrets: one key for many apps and agents, Webhooks for agent events, Advanced contract tools