סיכום שירותי רשת (APIs) ופרוטוקול HTTP

תוכן עניינים
המסמך מיועד גם למי שאינו טכני. הוא מסביר בצורה ברורה איך שירותי API ו‑HTTP עובדים ואיך אתם תשתמשו בהם באוטומציות ובסוכני AI ב‑n8n.
 
בהצלחה!

 

מהו API ולמה צריך אותו

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

 

דוגמאות מהיומיום:

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

 

מבנה שירות רשת:

  • שירות (API) – המערכת שנותנת את המידע או הפעולה (לדוגמה, מטבח במסעדה).
  • API-Endpoint – נקודת גישה ספציפית לשירות (למשל מלצר או מארחת במסעדה).
  • API-Call – הבקשה הספציפית שאתם שולחים לאותו Endpoint.
  • HTTP Request – ״פרוטוקול (הסכם) התקשורת״ – האופן שבה הבקשה עוברת ברשת (בדומה לשיחה בטלפון או הזמנה בפקס).

 

הזדהות ותשלום

  • רוב הבקשות ל‑API דורשות אלמנט זיהוי שמקשר ביניכם לבין השירות.
  • API Key הוא מפתח ייחודי שמזהה את הלקוח. שמרו עליו בסוד.
  • יש סוגים רבים של שיטות הזדהות. API Key הוא רק אחת מהן.
  • שירותים רבים משתמשים גם ב‑Token שהוא “תעודה זמנית” שניתנת לאחר כניסה, טוקן פג תוקף אחרי זמן מסוים וניתן לחדש אותו.
  • חלק מה‑APIs חינמיים או כוללים מכסה של בקשות ללא עלות; לאחר מכן תצטרכו לשלם לפי מספר הבקשות או כמות הנתונים שצרכתם.
  • בחרו את שיטת הזיהוי והחיוב המתאימה לצרכים שלכם ואל תשתפו את המפתחות עם אחרים.
  • פלטפורמת האוטומציה n8n תומכת באופן מובנה וחזותי בעשרות שיטות הזדהות שונות, ומאפשרות לכם להגדיר Credentials (״אישורי כניסה״) מסוגים שונים, לכל שירותי הרשת הנתמכים במערכת.
  • שירותי רשת שאינם נתמכים במערכת n8n באופן מובנה, עדיין ניתנים לגישה ישירה באמצעות בלוק HTTP Request המאפשר בניה ושליחה של קריאת רשת משלכם לכל שירות ברשת. השתמשו בו בחכמה.

 

API כמסעדה – אנלוגיה פשוטה

דמיינו שאתם מזמינים אוכל במסעדה.

 

  • המסעדה היא השירות – API (למרות שיש לו מרכיבים שונים כגון מטבח, חדר אוכל ומשרד הנהלה)
  • המלצר והמארחת הם API‑Endpoints שונים
  • בקשת השולחן היא API‑Call למארחת
  • ההזמנה שלכם היא API‑Call למלצר
  • אופן הגשת הבקשות שלכם למלצר או המארחת הוא HTTP Request

 

אתם אומרים למלצר מה אתם רוצים; המלצר מעביר את הבקשה למטבח ומחזיר לכם את המנה. כך עובדת גם קריאה ל‑API: אתם שולחים בקשת HTTP לנקודת הקצה המתאימה ומקבלים תשובה עם המידע או הביצוע שביקשתם.

 

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

HTTP – פרוטוקול התקשורת הנפוץ ביותר

HTTP (Hyper‑Text Transfer Protocol) הוא הסכם שיטת תקשורת (=״פרוטוקול״) בין לקוח לשרת באינטרנט. אתם לא צריכים לזכור את השם המלא, אבל חשוב להבין שזו “שפת הדיבור” שבאמצעותה שולחים ומקבלים בקשות.

 

בפרוטוקול HTTP קיימות שתי ישויות: לקוח (Client) שבונה ושולח את הבקשה ו‑שרת (Server) שמבצע את העבודה ומחזיר את המידע.

 

בקשת HTTP מורכבת משלושה חלקים עיקריים:

 

  • שורת הבקשה – מציינת את סוג הבקשה (Method), כתובת ה‑URL של השירות ופרמטרים נוספים שמופיעים מיד לאחר סימן שאלה. לדוגמא:

    GET https://example.com/resource?param=value
  • כותרות (Headers) – מכילות פרטי Meta-Data על סוג התוכן, מפתח API, סוג הלקוח ועוד.
  • גוף (Body) – מכיל את המידע עצמו שנשלח לשרת, אם הבקשה דורשת זאת (למשל נתוני טופס או קובץ).

 

פרמטרים בשורת הבקשה: אחרי סימן השאלה (?) מציינים שם של פרמטר ושל ערך, וניתן להוסיף מספר פרמטרים עם סימני &. כך תוכלו לבקש מהשירות לבצע סינון או חיפוש מסוים.

מתודות HTTP בסיסיות

אלו הן הפעולות הנפוצות ביותר שניתן לבקש:

 

  • GET – מבקשת מידע מהשרת מבלי לשנות אותו. תשתמשו בה כשאתם צריכים “לקרוא” נתונים (למשל לקבל רשימת לקוחות).
  • POST – שולחת נתונים לשרת כדי ליצור דבר חדש או לשנות את המצב שלו (למשל ליצור כרטיס משימה חדש במערכת CRM).
  • PUT – מחליפה תוכן קיים בפריט שלם.
  • DELETE – מוחקת פריט.
  • HEAD – מבקשת רק את הכותרות של הפריט (לבדיקת קיומו בלי לקבל את כולו).
  • OPTIONS – בודקת אילו פעולות מותרות על המשאב (שימושי לבדוק אפשרויות API).
  • PATCH – מעדכנת חלק מפריט קיים.

 

ברוב המקרים, תשתמשו רק ב GET ו – POST.

דוגמה של בקשה ותשובה

בקשת GET לכתובת https://official-joke-api.appspot.com/random_joke תחזיר בדיחה אקראית בפורמט JSON. אתם שולחים שורת בקשה ובתשובה מקבלים שדות כמו type, setup, punchline ו‑id.

 

  • השורה https://official-joke-api.appspot.com היא כתובת השירות. שימו לב שהיא נפתחת ב https – שמציין את ה״שפה המשותפת״ (הפרוטוקול) בה הלקוח והשרת ישוחחו. ה-s שבהמשך ל http מציין שזה ערוץ תקשורת HTTP מאובטח (secured).
  • החלק של /random_joke הוא ה End-Point.

 

כיוון שבקשה זו היא מסוג GET – ניתן לשלוח אותה ישירות משורת הכתובת של דפדפן אינטרנט! למתודות אחרות נדרש שימוש באפליקציה יעודית לביצוע קריאות API, כגון Postman.

טיפים פרקטיים לעבודה עם API ו‑HTTP ב‑n8n

  • קראו את התיעוד של כל שירות. שם מוסבר אילו Endpoints זמינים, אילו מתודות להשתמש, אילו פרמטרים קיימים ואיך לבצע הזדהות.
  • ב‑n8n יש Node של HTTP Request שבו מזינים את ה‑URL, המתודה, הפרמטרים והגוף. השתמשו בו כדי ליצור חיבורים לכל שירות חיצוני.
  • שמרו על API Keys ו‑Tokens בסוד. ב‑n8n ניתן לאחסן אותם כ‑Credentials ולא לחשוף אותם במפורש בזרימה.
  • בחרו את המתודה המתאימה: GET כדי להביא נתונים, POST או PUT כדי לשלוח ולעדכן, DELETE למחיקה.
  • הוסיפו פרמטרים ב‑Query כדי לצמצם תוצאות ולא להעמיס על השירות או לצרוך קריאות מיותרות.
  • בדקו את הכותרות בתשובה כדי להבין אם הבקשה הצליחה ומה סוג הנתונים שחזרו.
  • נצלו דוגמאות מהשקופיות: קראו מזג אוויר, התחברו לחשבונות חברתיים, או שלחו תשלומים – הכל באמצעות קריאות API דרך HTTP.

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