# API חיצוני

> חיבור APIs חיצוניים לאתרים, אפליקציות ומערכות, עם מיפוי נתונים, הרשאות, Webhooks וטיפול בשגיאות ובמגבלות שימוש.

העמוד המלא: https://oversight.co.il/use-cases/external-api

## בקצרה

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

## הפירוט

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

## מחיבור טכני לפעולה שימושית

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

## גם כשהתשובה אינה הצלחה

מגבלות שימוש, שגיאות ושינויים בממשק הם חלק מתכנון החיבור. כשמערכת תומכת ב-Webhooks, אפשר לקבל ממנה אירועים ולהפעיל את המשך העבודה בעקבותיהם, במקום לבדוק שוב ושוב אם משהו השתנה.

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

## נקודות לתשומת לב

### לא נעצרים ברשימת מותגים

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

### המידע מגיע במבנה הנכון

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

### האירוע מגיע כשהוא קורה

כשיש תמיכה ב-Webhooks, אירוע במערכת חיצונית יכול להפעיל פעולה אצלכם בלי להפוך את החיבור לבדיקה ידנית חוזרת.

### החיבור מתוכנן גם לחריגים

הרשאות, שגיאות ומגבלות שימוש מקבלות מקום באפיון, כדי שהמימוש לא ייבנה רק סביב התשובה המוצלחת.

## הפתרונות

### [אינטגרציות ו-API](https://oversight.co.il/solutions/integrations.md)

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

**ממשק שמתחבר לעבודה**

- קריאה ופעולות דרך API
- מיפוי והמרת נתונים
- Webhooks וטיפול בחריגים

## שאלות ותשובות

### אפשר להתחבר לכל מערכת שיש לה API?

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

### מה קורה כשהממשק החיצוני משתנה?

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

### אפשר לקבל אירועים בלי לבדוק שוב ושוב?

כן, כשמערכת המקור תומכת ב-Webhooks או במנגנון אירועים מתאים. מגדירים אילו אירועים מגיעים למערכת שלכם ומה הם מפעילים. כשהאפשרות אינה קיימת, בוחנים דרך אחרת בהתאם לממשק ולמגבלותיו, בלי להבטיח עדכון מיידי.

## פרויקטים

- [Nadlan.com](https://oversight.co.il/projects/nadlan.md): Nadlan.com
- [Lumo](https://oversight.co.il/projects/lumo.md)
- [SmartSend](https://oversight.co.il/projects/smartsend.md)
- [Origami.ms](https://oversight.co.il/projects/origami.md): Origami.ms
- [BreakHit](https://oversight.co.il/projects/break-hit.md): BreakHit
- [מזל חזוט](https://oversight.co.il/projects/mazalhazut.md): מזל חזוט
- [ממשקי ספקיות ל-ITC](https://oversight.co.il/projects/itc-provider-interfaces.md): ITC

## מונחים

- [API](https://oversight.co.il/glossary/api.md): ממשק תכנות יישומים: ערוץ מוגדר שדרכו מערכת אחת מבקשת מידע או פעולה ממערכת אחרת, בלי לדעת איך היא בנויה מבפנים.