מקורות ומפתחות

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

קונקטורים (מקורות)

קטע מקורות → קונקטורים. לקונקטור יש שם, סוג, כתובת URL בסיסית, פרטי כניסה מחוברים וכותרות:

  • REST — כל HTTP/JSON API.
  • OzmaDB — אינסטנס OzmaDB/FunDB; ב-URL הבסיסי מציינים שורש ה-REST API של האינסטנס, ובקשות לתצוגות אנונימיות פשוטות יותר.
  • IMAP — מסומן כ"בקרוב".

כפתור בדוק עושה בקשת ניסיון ומציג סטטוס ועיכוב (או שגיאה) — נוח לוודא שה-URL והמפתח נכונים.

פרטי כניסה (מפתחות)

קטע מפתחות → פרטי כניסה. הסודות נשמרים מוצפנים. סוגים:

  • מפתח API — מפתח + שם כותרת (ברירת מחדל Authorization).
  • Bearer token — טוקן בכותרת Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, שם משתמש, סיסמה, scope.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh token, scope.

עבור OAuth2 הפלטפורמה עצמה מקבלת ומאחסנת טוקנים, מחדשת אותם עם פקיעת תוקף ועל תגובת 401; רוטציית refresh token נשמרת. בעת עריכה שדה סוד ריק פירושו "אל תשנה".

קריאה וכתיבה מתגובות

  • שאילתת מקור (ds_query) — קורא נתונים דרך קונקטור ל-ctx: מציינים נתיב, JSONPath למערך ומפתח ctx לתוצאה. לאחר מכן המערך עובר לולאה על רשימה.
  • כתיבה למקור (ds_write) — שולח נתונים (POST/PUT/DELETE) עם גוף בפורמט JSON.

לבקשות חד-פעמיות ללא קונקטור שמור קיימת פעולת בקשת אינטרנט, ולהורדת טקסט דף — טעינת URL (ראה פעולות).

המשך