אינטגרציות ו־API
מפת האינטגרציות
החיבורים המתועדים, מה קיים בקוד ומה מחייב אימות והפעלה אצל ספק.
בעמוד הזה
חיבור ב־LinkNodes Energy נבחן לפי החוזה, מקור הנתונים, ההרשאה, התנהגות הכשל וראיות ההפעלה שלו. מדריך זה מתאר את מצב המקור המצולם במרכז התיעוד. הוא אינו מבצע בדיקת זמינות של ספקים בכל טעינת עמוד.
מפת החיבורים#
| תחום | מה מתועד במקור | גבול ההפעלה |
|---|---|---|
| Clerk ו־Supabase | אימות, JWT מהימן, חברות, RLS ופעולות שרת מצומצמות | אמון בין הספקים, הגדרות סביבה ובדיקות הרשאה של סביבת היעד |
| נתוני עמדות וגאוגרפיה | קטלוג רשת, מפעילים, ערים, רחובות וכתובות | מיקום במפה אינו זמינות חיה או הרשאה להתחיל טעינה |
| זיהוי רכב | lookup ורישום עובדות רכב דרך מסלול מאומת | מקור רישוי אינו טלמטריה, קריאת סוללה או אימות בעלות על רכב |
| ספקי טעינה | חוזי ספק ותשתיות למצבי פעולה ואירועים | מתאם, הרשאות ספק, מדידות וראיות קצה לקצה עדיין נבחנים בנפרד |
| יבוא אנרגיה | API מורשה ליבוא מנורמל וקריאה מאוחדת | יבוא לקוח נשאר לא מאומת; אינו receipt, CDR מאושר או תשלום |
| HYP | קוד חיוב, ניסיונות תשלום, התאמה, מסמכים והחזרים | מסוף, credentials, בדיקות ומתָגים מפורשים לפני פעולה חיצונית |
| Redis ו־BullMQ | תורים, worker וחוזה הרצה נפרד | בדיקת smoke לתשתית אינה הפעלת תור עסקי או מעבד ספק |
| טפסי החברה | Turnstile, אימות שרת, Edge Function וכתיבה פרטית | תיעוד הטפסים אינו חיבור אוטומטי למייל או למערכת גיוס |
| PostHog ו־Grafana | instrumentation וסינון נתונים לפי פלטפורמה | איסוף תלוי בהגדרות ובהפעלה; טלמטריה אינה ראיה לזמינות עסקית |
| מייל ו־WhatsApp | ממשקי תקשורת בטיוטת Admin | חשבונות ומתאמים אמיתיים עדיין נפרדים מהדגמת הממשק |
| זהות ארגונית | תכולת Enterprise וטיוטות SSO/SCIM | זכאות מסלול אינה חיבור IdP או provisioning של ארגון מסוים |
המקורות המלאים: ארכיטקטורה, נתוני הרשת, רישוי, יומן אנרגיה, HYP, Redis, טפסי החברה, ניטור מובייל וטיוטת תקשורת.
אירוע טעינה מאומת וחיוב עמלה#
חוזה החיוב הנוכחי דורש אירוע חדש הזכאי למדיניות, מצב השלמה, מזהי ספק ואישור מפורש שסכום הספק סופי באמצעות provider_amount_finalized_at. ברירת מחדל מספרית של אפס אינה אישור שהטעינה הייתה חינם. כאשר המחיר הסופי חסר, הפריט ממתין להשלמה; לאחר אישורו נשמר סכום מקור קבוע לצורך חישוב העמלה.
המדיניות החדשה אינה יוצרת עמלות היסטוריות על רשומות ישנות. סכום סופי מאושר של אפס, או עמלה שמתעגלת לאפס, נרשמים כ־no_charge ללא חיוב מינימום. כשאין מנוי או אמצעי תשלום מתאים, ההשלמה אינה נזרקת: תור העבודה שומר מצב המתנה לפי חוזה המקור.
העמלה היא 0.99% לפני מע״מ בכל המסלולים. מסילת HYP המתועדת מטפלת בעמלת LinkNodes; היא אינה הוכחה שהחברה סולקת את מלוא מחיר הטעינה עבור המפעיל. תוצאת תשלום שאינה ידועה מחייבת התאמה לפני ניסיון שעלול לחייב שוב. עיבוד תור פנימי יכול לפעול בזמן שהמתאם החיצוני כבוי. פירוט הרשאות, idempotency, הקפאת סכום ומתגי הפעלה נמצא במסמך HYP.
חוזי API ונתוני ספק#
OpenAPI ואוסף Postman מציגים את חוזי הבקשות המתועדים. הפניה למשתנה סביבה אינה ערך סוד ואינה הרשאה להשתמש בחשבון. בקשת ספק צריכה להיות מזוהה בצד השרת, עם מזהה עסקה יציב, יחידות מוגדרות והתנהגות ברורה לכפילויות ולסתירות.
ביומן האנרגיה, רשומות יבוא מסומנות customer_import_unverified. חזרה זהה יכולה להיות idempotent; תוכן סותר דורש התאמה ואינו רשאי להחליף עובדה מאומתת בשקט. חשמל ודלק אינם מתאחדים ליחידת כמות מלאכותית. מסמך הסתירות מפרט את ההתנהגות.
מה מהווה ראיית קבלה לחיבור#
קבלה של חיבור דורשת יותר ממסך פעיל: חוזה ספק ידוע, זהות מהימנה, הרשאות מתאימות, טיפול בכשל, בדיקת כפילויות, נתוני מקור ותוצאה שאפשר להתאים. תיעוד של ספק ברשימת העדפות, או לוגו במפה, אינם מהווים את הראיות האלה. שערי הקבלה נמצאים במפרט המוצר ובמסמך הפרטני של האינטגרציה.