מהו REST API וכיצד תוכל לאסוף נתונים לאפליקציה או לאתר שלך?

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

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

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

כיצד עובד ממשק API של REST?

א REST API ניגש לנתונים באמצעות מזהי משאבים אחידים (URI), שהם מחרוזת תווים המזהים משאב ספציפי. סוג ה- URI המשמש א REST API הוא איתור משאבים אחיד (URL).

כדי לגשת ולתפעל משאבים, REST API משתמש בפעלים הבקשה הבאים:

• Get (זה משמש לרכישת נתונים ממסד נתונים)
• פרסם (הוסף נתונים חדשים למסד נתונים)
• Put (עדכן את הנתונים במסד נתונים)
• מחק (מחק נתונים ממסד נתונים)

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

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

ה API מפתח הוא מזהה ייחודי, שתקבל ברגע שתירשם ל- REST API פּלַטפוֹרמָה. השאילתה היא בדרך כלל משוואה פשוטה המשמשת להתאמה אישית של החיפוש שלך. לכן, אם ברצונך לקבל את מזג האוויר הנוכחי בניו יורק, חלק השאילתות של כתובת האתר שלך עשוי להיות "עיר = ניו יורק".

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

שימוש ביישום JavaScript כדי לתפוס נתונים מממשקי API שונים של מנוחה

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

לאחר התקנת היישומים למעלה במחשב שלך, עליך לבצע את השלבים הבאים:

1. פתח את IDE והפעל את הטרמינל.
2. נווט לתיקייה המכילה את קובץ יישום ה- JavaScript שלך באמצעות הפקודה cd.
3. אתחל npm עם שורת הקוד הבאה:

npm init -y

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

התקנת npm קיבלה@האחרונה

כעת תוכל להמשיך ולבנות את האפליקציה שלך.

שימוש בספריית Got לבניית האפליקציה שלך

// ייבא את הספרייה שקיבלת ליישום שלך
const got = require ('got');
// להביא נתונים מממשק API ספציפי של REST ומדפיס את גופם למסוף
(async () => {
נסה {
const const = wait for got (URL);
נתוני const = JSON.parse (response.body);
console.log (נתונים);
} לתפוס (שגיאה) {
console.log (error.data);
}
})();

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

ליקוט נתונים מממשק REST API של מזג אוויר

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

שימוש ב- API של REST Weatherbit.io

// ייבא את הספרייה שקיבלת ליישום שלך
const got = require ('got');
// להביא נתונים מממשק API ספציפי של REST ומדפיס את גופם למסוף
(async () => {
נסה {
const URL = ' https://api.weatherbit.io/v2.0/current? lat = 40.7128 & lon = -74.0060 & key = API_KEY ';
const const = wait for got (URL);
נתוני const = JSON.parse (response.body);
console.log (נתונים);
} לתפוס (שגיאה) {
console.log (error.data);
}
})();

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

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

למידע נוסף על אופן השימוש ב- Weatherbit.io REST API, לחץ כאן.

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

Weatherbit.io REST API לדוגמא תגובה

נתונים: [
{
rh: 53,
תרמיל: 'd',
lon: -74.01,
pres: 1005.9,
אזור זמן: 'אמריקה/ניו_יורק',
ob_time: '2021-09-27 14:50',
code_code: 'US',
עננים: 25,
ts: 1632754200,
solar_rad: 652.8,
state_code: 'NY',
city_name: 'ניו יורק',
wind_spd: 5.66,
wind_cdir_full: 'מערב-דרום-מערב',
wind_cdir: 'WSW',
slp: 1015.9,
vis: 5,
h_angle: -30,
שקיעה: '22: 44 ',
dni: 851.72,
טל: 12,
שלג: 0,
uv: 5.68859,
משקעים: 0,
wind_dir: 240,
זריחה: '10: 49 ',
ghi: 657.55,
dhi: 106.79,
אקי: 53,
lat: 40.71,
מזג אוויר: [אובייקט],
תאריך: '2021-09-27: 14',
טמפ ': 22,
תחנה: 'KJRB',
elev_angle: 40.89,
app_temp: 21.7
}
],
ספירה: 1
}

כמה מההיבטים החשובים יותר של הנתונים המוחזרים בתגובה כוללים:

• שם העיר (מחזירה את שמה של העיר באורך הקו הרוחב שנקבע).
• תאריך שעה (מחזירה את שעת המחזור הנוכחית בפורמט YYYY-MM-DD: HH).
• מזג אוויר (מחזיר אובייקט המכיל סמל מזג אוויר, קוד מזג אוויר ותיאור טקסט של מזג האוויר).

ליקוט נתונים מממשק API של חדשות REST

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

באמצעות יישום JavaScript, תוכל לאחזר נתונים מהחדשות REST API. כל שעליך לעשות הוא להחליף את כתובת האתר ביישום למעלה בכתובת האתר הבאה:

' https://newsdata.io/api/1/news? apikey = YOUR_API_KEY & country = us '

השלב הבא הוא החלפת הקטע "YOUR_API_KEY" בכתובת האתר למעלה ב API מפתח שתקבל לאחר שתירשם ל- Newsdata.io. כתובת האתר למעלה תחזיר חדשות מעולות מאמריקה. עם זאת, אם אתה רוצה חדשות מיפן, אתה יכול פשוט להחליף את שאילתת "contry = us" ב "country = jp".

למידע נוסף על אופן השימוש ב- Newsdata.io REST API, לחץ כאן.

קָשׁוּר: רוצה להוסיף כותרות חדשות לאתר או לאפליקציה שלך? אתה צריך Mediastack API

Newsdata.io REST API תגובה לדוגמה

{
כותרת: 'נהג נהרג מדלת המכונית שלו בזמן שהמתין בתור במסלול מזון מהיר, ומספק תובנות זהירות למכוניות בעלות נהיגה עצמית',
קישור: ' https://www.forbes.com/sites/lanceeliot/2021/09/27/driver-killed-by-his-own-car-door-while-waiting-in-line-at-fast-food-drive-thru-providing-cautionary-insights-for-ai-self-driving-cars/',
מילות מפתח: [מערך],
יוצר: [מערך],
video_URL: null,
תיאור: "סיפור חדשות עצוב על נהג שנהרג מדלת המכונית שלו (כשהוא בנסיעת נסיעה), מספק תובנות אזהרה לגבי
הופעתן של מכוניות מבוססות AI שנוהגות בעצמן. הנה המראה הפנימי. ",
תוכן: "סיפור חדשות עצוב על נהג שנהרג מדלת המכונית שלו (בזמן נסיעה), מספק תובנות מזהירות לגבי
הופעת מכוניות המבוססות על AI המבוססות על AI. הנה המראה הפנימי. ",
תאריך pub: '2021-09-27 15:30:00',
כתובת אתר של תמונה: ' https://thumbor.forbes.com/thumbor/fit-in/0x0/filters%3Aformat%28jpg%29/https://specials-images.forbesimg.com/imageserve/614272b9f18bec6882652695/0x0.jpg? cropX1 = 23 & cropX2 = 2455 & cropY1 = 23 & cropY2 = 1538 ',
source_id: 'forbes'
}

שימוש ביישום Python לתפוס נתונים מממשקי API שונים של מנוחה

אפשר לתפוס נתונים לאתר או ליישום שלך באמצעות כל שפת תכנות שאתה מכיר. לכן, אם אינך רוצה להשתמש ב- JavaScript, תוכל להשיג את אותן התוצאות באמצעות יישום Python.

קָשׁוּר: כיצד לבנות ממשקי API ב- Python: מסגרות פופולריות

כל שעליך לעשות הוא להתקין את מודול פייתון HTTP לבקשות באמצעות סביבת ה- pip. לאחר מכן תוכל לבנות את יישום Python שלך באמצעות הקוד הבא:

# ייבא את ספריית הבקשות
בקשות ייבוא
# לכידת נתונים באמצעות ספריית הבקשות
URL = ' https://newsdata.io/api/1/sources? apikey = YOUR_API_KEY = אנחנו '
res = requests.get (URL)
json = res.json ()
עבור מפתח ב- json:
print (key, json [key])

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

לתפוס נתונים לאתר או ליישום שלך זה די פשוט

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

עכשיו אתה יודע איך להשתמש Rest API, למה לא לנסות?

גירוד אתרים לעומת API: מהי הדרך הטובה ביותר לחלץ נתונים?

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

קרא הבא

על הסופר