התחלה
אימות ומפתחות
כל קריאה נושאת מפתח API. המפתח שייך לחשבון שלכם, רואה רק את הפרויקטים שלכם ומחייב את היתרה שלכם.
שליחת המפתח#
Authorization: Bearer wtf_live_…כל נקודת קצה חוץ מ-/openapi.json דורשת אותו. מפתח חסר או שגוי מקבל 401 עם הכותרת WWW-Authenticate.
מפתח נראה כך: wtf_live_ ואחריו 32 אותיות וספרות באנגלית.
יצירה וביטול#
- יוצרים מפתחות בעמוד /developers. כדאי לתת לכל מפתח שם לפי המקום שבו הוא רץ (שרת, סוכן, Zapier).
- המפתח מוצג פעם אחת. אנחנו שומרים רק hash מסוג SHA-256 שלו וצורה מקוצרת לתצוגה, כמו wtf_live_Ab12…9xYz, כך שאין דרך לשחזר מפתח שאבד.
- עד 20 מפתחות פעילים לחשבון.
- ביטול נכנס לתוקף בבקשה הבאה.
מי יכול ליצור מפתח#
גישה ל-API ול-MCP היא חלק מחבילות Pro ו-Studio. כדי ליצור מפתח צריך חבילה פעילה, ומנהלים יכולים תמיד. מפתח קיים ממשיך לעבוד בזמן שחידוש שנכשל מנוסה שוב, ומפסיק כשהחבילה מסתיימת: הקריאות מקבלות 403 עם הקוד plan_required.
מה מפתח יכול לעשות#
כל מה שהחשבון יכול לעשות בסטודיו, רק על הפרויקטים, הקבצים והסקילים שלו. מזהה של חשבון אחר מקבל 404, בדיוק כמו מזהה שלא קיים. כל שלב בתשלום יורד מהיתרה של בעל המפתח.
מפתחות מנהל#
מנהלים יכולים לבחור בהיקף admin כשהם יוצרים מפתח. רק מפתחות כאלה פותחים את שרת ה-MCP למנהלים, והם מפסיקים לעבוד ברגע שבעל המפתח יוצא מרשימת המנהלים. מפתח כזה שווה לסיסמת מנהל.
שמירה על המפתח#
- מפתח גר בצד השרת, במשתנה סביבה או במנהל סודות. לא בקוד שנשלח לדפדפן ולא ב-git.
- ה-CORS פתוח (
Access-Control-Allow-Origin: *), כך שאפשר לקרוא ל-API גם מדפדפן. מי שפותח עמוד שנושא מפתח יכול לקרוא אותו, ולכן זה מתאים רק לכלים פנימיים. - אם מפתח דלף: מבטלים אותו ב-
/developersויוצרים חדש.