דילוג לתוכן
מרכז התיעוד
לאתר LinkNodes Energy
LinkNodesENERGYתיעוד

טוענים את החיפוש…

    חיפוש גם בתוך המאמרים ↑ ↓ לניווט Esc לסגירה

    לאתר החברה

    אינטגרציות ו־API

    מפת האינטגרציות

    החיבורים המתועדים, מה קיים בקוד ומה מחייב אימות והפעלה אצל ספק.

    בעמוד הזה

    חיבור ב־LinkNodes Energy נבחן לפי החוזה, מקור הנתונים, ההרשאה, התנהגות הכשל וראיות ההפעלה שלו. מדריך זה מתאר את מצב המקור המצולם במרכז התיעוד. הוא אינו מבצע בדיקת זמינות של ספקים בכל טעינת עמוד.

    מפת החיבורים#

    תחוםמה מתועד במקורגבול ההפעלה
    Clerk ו־Supabaseאימות, JWT מהימן, חברות, RLS ופעולות שרת מצומצמותאמון בין הספקים, הגדרות סביבה ובדיקות הרשאה של סביבת היעד
    נתוני עמדות וגאוגרפיהקטלוג רשת, מפעילים, ערים, רחובות וכתובותמיקום במפה אינו זמינות חיה או הרשאה להתחיל טעינה
    זיהוי רכבlookup ורישום עובדות רכב דרך מסלול מאומתמקור רישוי אינו טלמטריה, קריאת סוללה או אימות בעלות על רכב
    ספקי טעינהחוזי ספק ותשתיות למצבי פעולה ואירועיםמתאם, הרשאות ספק, מדידות וראיות קצה לקצה עדיין נבחנים בנפרד
    יבוא אנרגיהAPI מורשה ליבוא מנורמל וקריאה מאוחדתיבוא לקוח נשאר לא מאומת; אינו receipt, CDR מאושר או תשלום
    HYPקוד חיוב, ניסיונות תשלום, התאמה, מסמכים והחזריםמסוף, credentials, בדיקות ומתָגים מפורשים לפני פעולה חיצונית
    Redis ו־BullMQתורים, worker וחוזה הרצה נפרדבדיקת smoke לתשתית אינה הפעלת תור עסקי או מעבד ספק
    טפסי החברהTurnstile, אימות שרת, Edge Function וכתיבה פרטיתתיעוד הטפסים אינו חיבור אוטומטי למייל או למערכת גיוס
    PostHog ו־Grafanainstrumentation וסינון נתונים לפי פלטפורמהאיסוף תלוי בהגדרות ובהפעלה; טלמטריה אינה ראיה לזמינות עסקית
    מייל ו־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; תוכן סותר דורש התאמה ואינו רשאי להחליף עובדה מאומתת בשקט. חשמל ודלק אינם מתאחדים ליחידת כמות מלאכותית. מסמך הסתירות מפרט את ההתנהגות.

    מה מהווה ראיית קבלה לחיבור#

    קבלה של חיבור דורשת יותר ממסך פעיל: חוזה ספק ידוע, זהות מהימנה, הרשאות מתאימות, טיפול בכשל, בדיקת כפילויות, נתוני מקור ותוצאה שאפשר להתאים. תיעוד של ספק ברשימת העדפות, או לוגו במפה, אינם מהווים את הראיות האלה. שערי הקבלה נמצאים במפרט המוצר ובמסמך הפרטני של האינטגרציה.