למה מייצג API? דוגמאות כיצד להשתמש בממשקי API

למה מייצג API? דוגמאות כיצד להשתמש בממשקי API

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





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



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





מהו API?

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

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



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

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



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

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



כיצד ממשקי API עוזרים לך לפתח אפליקציות מהר יותר

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

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

כיצד לכבות כתוביות ב- Netflix

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

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

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

מאמר זה לא ימשיך להסביר את ה- REST API. התמקד ביסודות בינתיים.

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

מהי נקודת קצה API?

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

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

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

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

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

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

כללי שילוב API

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

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

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

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

כדי לסיים את זה, קריאת API עוסקת ב כותרות , א נקודת קצה , ה בַּקָשָׁה , וה תְגוּבָה או ה גוּף .

למרות שהסברנו מהי נקודת סיום, בואו נפרק עוד את המונחים הבאים:

כותרות

בדרך כלל, עליך לתאר שתי צורות של כותרות בעת חיבור ל- API: ה- בַּקָשָׁה וה תְגוּבָה כותרות.

ה כותרת בקשה הוא השער של קריאת API. הוא מתאר את גישת הלקוח לגישה למשאב. זה עשוי לפרט דברים כמו סוג חיבור מקובל, פרטי proxy וסוג הנתונים (JSON, XML או HTML) שברצונך לקבל מה- API.

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

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

בקשת API

בקשת API בדרך כלל מכילה את נקודת הסיום בכתובת URL (Unique Resource Locator). הוא משתמש בפרוטוקול העברת הטקסט (Hypertext Transfer Protocol) (HTTP) לאיתור כתובת המשאב שאליו אתה מנסה לגשת באמצעות ממשק API. בסופו של דבר, בקשת API אינה מלאה אם ​​אינך כולל את נקודת הסיום בכתובת האתר.

אם מישהו מבטל את חשבון הפייסבוק שלו ההערות שלו נעלמות

תגובת API

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

לאחר שתקבל תגובה מממשק API, תוכל לראות בקריאת ה- API שלך הצלחה.

אופן השימוש בממשקי API: דוגמאות מעשיות

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

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

קָשׁוּר: כיצד להפעיל את סקריפט ה- Python שלך

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

import requests
endpoint = 'https://football-prediction-api.p.rapidapi.com/api/v2/predictions'
queryparams = {'market':'classic','iso_date':'2021-01-01','federation':'UEFA'}
#Define the request header:
headers = {
'x-rapidapi-key': 'Paste your access key here',
'x-rapidapi-host': 'football-prediction-api.p.rapidapi.com'
}
#Define the response header:
response = requests.request('GET', endpoint, headers=headers, params=queryparams)
#Get the response:
print(response.text)

המשך ללמוד: כיצד להשתמש בממשק ה- API של IPStack לחיפושים במיקום גיאוגרפי של IP

מה דעתך לקבל את הטמפרטורה והלחות הנוכחיים של מקום באמצעות ממשק API של Weatherstack עם פייתון? להלן דוגמה למטה:

import requests
endpoint = 'http://api.weatherstack.com/current'
headers = {
'access_key': 'Paste your access key here',
'query': 'California'
}
req = requests.get(endpoint, headers)
res = req.json()
print(u'Current temperature in %s is %d℃' %
(res['location']['name'], res['current']['temperature']))
print(u'Current humidity in %s is %d℃' %
(res['location']['name'], res['current']['humidity']))

סוגי ממשקי API שתוכל לשלב

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

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

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

פשט את פיתוח האפליקציות באמצעות ממשקי API

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

לַחֲלוֹק לַחֲלוֹק צִיוּץ אימייל כיצד פועלים ממשקי API וכיצד ניתן לשלב אותם באפליקציה שלך

שימוש בממשקי תכנות אפליקציות (API) הוא מיומנות חיונית עבור כל המתכנתים להשתלט עליהם.

קרא הבא נושאים קשורים
  • תִכנוּת
  • תִכנוּת
  • אֵשׁ
  • ז'רגון
  • טיפים לקידוד
על הסופר אידיסו אומיסולה(פורסמו 94 מאמרים)

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

עוד מאת Idowu Omisola

הירשם לניוזלטר שלנו

הצטרף לניוזלטר שלנו לקבלת טיפים, סקירות, ספרים אלקטרוניים בחינם ומבצעים בלעדיים!

לחצו כאן להרשמה