REST API וטוקנים

מעבר לבונה הוויזואלי, GetMyBot פתוח תכנותית: ניתן לנהל נתוני בוט דרך REST API. קיימים שני סוגי טוקנים — לגישה לבוט ספציפי ואישיים (לאוטומציה ואינטגרציות ברמת החשבון).

טוקני API של בוט

נוצרים בהגדרות → טוקני API. כל טוקן קשור לבוט ומאפשר גישה ל-REST endpoint שלו (תגובות, משתמשים, קולקציות, סטטיסטיקה וכו'). הטוקן מוצג פעם אחת בלבד עם היצירה — שמרו אותו במקום בטוח; הרשימה מציגה שם, מסכה ותאריך יצירה. מחקו טוקנים מיותרים.

טוקני גישה אישיים (PAT)

טוקני גישה אישיים (PAT, מתחילים ב-mbp_) פועלים ברמת החשבון ומשמשים לאוטומציה ואינטגרציות. נוצרים בפרופיל האישי; מועברים בכותרת Authorization: Bearer mbp_…. לטוקן יש הרשאות (scopes) — סט הרשאות בצורת משאב:פעולה (לדוגמה, reactions:read, bots:write), ו-* מייצג גישה מלאה. תוקף הטוקן מוגבל, והטוקנים עצמם נשמרים בצורה מגובבת. זו דרך נוחה לתת לסקריפט גישה מוגבלת מבלי למסור סיסמה.

מה זמין דרך API

דרך ה-API נגישות אותן ישויות שבממשק: בוטים והגדרותיהם, תגובות (כולל ייבוא/ייצוא), מנויים ותגיות, קולקציות ורשומות, סטטיסטיקה ויומן בקשות, רסילות. זה מאפשר לבנות לוחות ניהול, סנכרונים ואוטומציות מעל GetMyBot.

ערוצים ו-WhatsApp

GetMyBot הוא רב-ערוצי (Telegram + WhatsApp + VK), וערוצי הבוט מנוהלים גם דרך REST. ערוצים ותבניות WhatsApp מוגבלים על ידי ה-scopes המשותפים bots:read / bots:write — אין scope נפרד לערוץ.

  • GET /api/channels/capabilities — מטריצת יכולות הערוצים (נקודת קצה של סשן, אינה דורשת scope של PAT).
  • GET /api/bots/{botID}/channels (bots:read) — רשימת ערוצי הבוט.
  • POST /api/bots/{botID}/channels (bots:write) — חיבור ערוץ WhatsApp או VK.
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — ניתוק ערוץ.
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — קטלוג תבניות WhatsApp של הערוץ.
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — יצירת תבנית ושליחתה ל-Meta לבדיקה.
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — סנכרון מחדש של הקטלוג מ-Meta.
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — עריכת תבנית.
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — מחיקת תבנית.
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — העלאת דוגמת מדיה לכותרת (תמונה/וידאו/מסמך).

סכמות בקשה ותגובה, פרמטרים ודוגמאות נמצאים ב-תיעוד API.

גישה ממובייל

לפלטפורמה יש אפליקציה ניידת עם אימות משלה (טוקני access ו-refresh) ולוח מחוונים מאוחד של בוטים — היא משתמשת באותו backend.

תיעוד API

התיעוד האינטראקטיבי המלא לפי ה-API הציבורי זמין בדף תיעוד API: שם מפורטים כל ה-endpoint הנגישים ב-PAT, פרמטרים, סכמות בקשות ותגובות, scopes נדרשים ודוגמאות בקשות מוכנות (curl, JavaScript, Python). ניתן לבצע בקשת ניסיון עם הטוקן שלך ישירות מהדף.

אבטחה

  • טוקנים מוצגים פעם אחת; שמרו אותם כסודות.
  • סודות בוטים ופרטי כניסה נשמרים מוצפנים.
  • מוטציות נרשמות ביומן ביקורת.

המשך