איך אתרים עובדים עם API
חלק 2

בלי כתוביותעם כתוביות

מילון מושגים:

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

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

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

פרוטוקול - מערכת כללים מוסכמת שקובעת כיצד מכשירים או תוכנות מתקשרים ומחליפים מידע, למשל HTTP או TCP.

HTTPS - הגרסה המאובטחת של HTTP, שמצפינה את התקשורת בין הדפדפן לשרת בעזרת TLS ומאמתת את זהות האתר.

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

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

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

איך אתרים עובדים עם API חלק 2

ההרצאה הקודמת מציגה את האתר הגרפי. עכשיו מסתכלים על ה-API עצמו ורואים את הנתונים הגולמיים לפני שהם הופכים לתצוגה.

השלבים העיקריים

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

2. API key: אחרי פתיחת חשבון, שאפשרית לכל אחד, מקבלים API key חינמי ששולחים עם הבקשות.

3. הגדרת הבקשה: מזינים את ה-API key, בוחרים פרוטוקול HTTPS ופורמט JSON, ובמיקום מכניסים תל אביב.

4. התשובה: קוד ה-Response הוא 200, והתשובה כוללת נתונים גולמיים בפורמט JSON בלי עיצוב גרפי, כולל המיקום שביקשנו והתחזית.

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

שימו לב

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

השיעור הבא בקורס: התקנה של פוסטמן - Postman

פרקי ההרצאה: איך אתרים עובדים עם API חלק 2

תמלול ההרצאה: איך אתרים עובדים עם API חלק 2

הטקסט המלא של הדקות הראשונות בהרצאה «איך אתרים עובדים עם API חלק 2» בקורס הווידאו של PracticU – כתוביות בעברית עם זמן התחלה לכל פסקה. כך תוכלו לקרוא ולחפש את הנושאים לפני שמתחילים ללמוד.

00:02
ראינו אתר מזג אוויר וראינו איך הוא עובד ברמה העליונה, ברמה הגרפית, מול המשתמש של הדפדפן. עכשיו בואו נראה את החלק של ה-API, כשאני רוצה לראות נתונים גולמיים, איך השרת בעצם עובד ומקבל נתונים כדי לשלוח לשכבה של הגוי את הנתונים אחר כך, לאחר מכן.
00:23
אני נכנס לאתר שנקרא weatherapi.com, זה אתר שמספק שירותי מידע על מזג אוויר לאתרים ברחבי העולם. אני נרשמתי לאתר ואני נכנס לחלק של הדוקומנט של האתר.
00:38
אז אנחנו רואים פה מה האתר מציע. אני נכנס ל-API Explorer ופה אנחנו רואים דוגמה של ממשק API ללא GUI שאנחנו יכולים להשתמש בו כדי לראות את המידע שאנחנו יכולים לשלב באתר שלנו בממשק הגרפי שלנו אבל כרגע רק את המידע הגולמי הנתונים עצמם.
00:59
אז פה הוא מבקש ממני API key, אני שותה לו API key ברגע שאני מייצר אקאונט, כל אחד יכול לייצר אקאונט ומקבל API key חינמי שמאפשר לנו לשלוח את הבקשות.
01:12
שמתי את ה-API key, פרוטוקול אני אבחר HTTPS, HTTP Secure ואני אומר בפורמט Json, אנחנו נדבר אחר כך מה זה Json ואת המיקום אני אעשה לדוגמה תל אביב.
01:26
אני רוצה לראות את ה-Response, מה הנתונים שאני אקבל. הוא מראה לי את הבקשה ששלחתי דרך הממשק הגרפי של האתר הזה, אבל כשהאתר שלנו ירצה לשלוח את הממשק ולקבל מידע, אז הוא ישלח את ה-Request בצורה הזאת.
01:43
ה-Response קוד הוא 200, ופה יש לנו נתונים גולמיים של הנזק אוויר למיקום שביקשנו. אתם רואים? המידע מגיע בפורמט של JSON, והוא מכיל רק נתונים, שום עיצוב גרפי למשתמש.
01:58
כשאנחנו נרצה לשלב את המידע הזה באתר שלנו, אנחנו נצטרך לשלב את הבקשה הזאתי ונוכל לשלב