מה זה API? הסבר פשוט עם דוגמאות

הגדרה בשורה אחת

API (קיצור של Application Programming Interface) הוא הדרך שבה שתי תוכנות מדברות זו עם זו — בלי שאדם יצטרך להעתיק מידע ביניהן.

זה הכול. כל השאר זה פרטים.

איך זה עובד

דמיינו מלצר במסעדה.

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

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

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

דוגמאות מהשטח

טופס באתר ששולח לוואטסאפ. האתר שלכם מדבר עם וואטסאפ דרך API.

חנות שמציגה מלאי מהמחסן. האתר שואל את מערכת המלאי כמה יש, דרך API.

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

מפה בדף יצירת הקשר. האתר מבקש ממפות גוגל להציג את המיקום.

למה זה משנה לעסק שלכם

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

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

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

מה לשאול כשמישהו אומר לכם "API"

"למה בדיוק זה מתחבר?" שם המערכת, לא "למערכות שלכם".

"מה קורה אם הצד השני משנה משהו?" מערכות מתעדכנות, וחיבור שעבד יכול להישבר. מי אחראי לתקן, ובאיזה זמן תגובה.

"יש לזה עלות שוטפת?" חלק מהשירותים גובים לפי כמות קריאות. זו עלות שלא תמיד מופיעה בהצעה.

מושגים קרובים

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

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

API מול בסיס נתונים. בסיס הנתונים מחזיק את המידע; ה-API הוא הדרך המסודרת לבקש אותו, עם הרשאות ובלי גישה ישירה.

שאלות נפוצות

כל אתר צריך API?

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

זה מסוכן מבחינת אבטחה?

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

כמה עולה לחבר מערכת?

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

אפשר להתחיל בלי ולהוסיף אחר כך?

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

שורה תחתונה

API הוא המלצר שמעביר בקשות בין תוכנות, ובלעדיו כל מערכת היא אי.

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