הבנה של ארכיטקטורת REST API

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

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

איך זה עובד

REST (Representational State Transfer) הוא קבוצת כללים (guidelines) לבניית Web Service, שפותחה בשנת 2000 על ידי רוי פילדינג. REST לא קובעת שפת תכנות מסוימת - שירות שעומד בכללי REST נקרא RESTful Service או REST API (API = Application Programming Interface, הממשק שהשרת חושף ללקוחות). השיטה מבוססת כולה על פרוטוקול HTTP: הבקשה והתשובה בנויות בדיוק כמו מסמכי HTTP Request ו-Response, רק שבמקום דף אינטרנט מוחזר מידע (בפורמט JSON).

המושגים המרכזיים

1. Resource: במקום כתובת של דף, ב-REST יש כתובת של משאב (Resource) - למשל ספרים, לקוחות או ספקים - שנקראת Resource URL.

2. GET - קבלת מידע: בקשת GET לנתיב כמו /api/books מבקשת לקבל מידע (למשל רשימת כל הספרים), בלי Body בבקשה. השרת מחזיר קוד 200 ואת המידע בפורמט JSON (מערך אובייקטים, כל אחד עם ID ייחודי).

3. POST - הוספת מידע: בקשת POST לאותו נתיב שולחת בגוף הבקשה (Body) את פרטי הפריט החדש (בלי ID - זה נוצר בדאטהבייס). השרת מחזיר קוד 201 (Created) ואת הפריט שנוצר.

4. שגיאה: בקשה לכתובת שלא קיימת מחזירה קוד 404 (Not Found) ואובייקט JSON עם הודעת שגיאה.

5. שאר המתודות: PUT משמש לעדכון מלא של פריט קיים (שולחים את כל הפרטים), PATCH לעדכון חלקי (שולחים רק את השדות שמשתנים), ו-DELETE למחיקת פריט.

שימו לב

אותה כתובת (Resource URL) יכולה לשמש כמה פעולות שונות - ה-method (GET, POST וכדומה) הוא זה שקובע לשרת איזו פונקציה להפעיל, לא רק הכתובת עצמה.

בסיום ההרצאה מבינים את עקרון העבודה של REST API ואיך הוא מנצל את פרוטוקול HTTP לבקשת וקבלת מידע.

השיעור הבא בקורס: מוסכמות ב-REST API

פרקי ההרצאה: הבנה של ארכיטקטורת REST API

תמלול ההרצאה: הבנה של ארכיטקטורת REST API

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

00:02
אנחנו מגיעים לארכיטקטורת רסט. כאן אנחנו הולכים להיכנס יותר פנימה לתוך מה זה אומר רסטפול סרוויס. אז קודם כל מה זה רסט? זה ראשי תיבות של Representational State Transfer.
00:17
זה בעצם שיטה פופולרית לבניית וב סרוויס. זה אחת מהשיטות לבניית וב סרוויס. פותחה ב-2000 על ידי בחור בשם רוי פילדינג. זה סך הכל גיידליינס. או קווים כלליים שאומרים איך בעצם להעביר מידע ולקבל מידע, REST לא מתעסקת עם המימוש, אפשר לממש את זה בכל שפת תכנות שהיא.
00:40
אם איזשהו Web Service שאנחנו בונים הוא עובד בדיוק לפי כללי REST, אז הוא נקרא RESTful Service או RESTful API או בקיצור REST API. כאשר API זה Application Programming Interface, זה הממשק שאנחנו חושפים מהשרת בשביל שלקוחות יוכלו לקבל מידע דרגו.
01:00
המידע שאנחנו בעצם רוצים לשלוח ולקבל מאותו Web Service, בהקשר שלנו Rest, זה סך הכל מידע שנשלח ומתקבל בתוך המתמחים של ה-HTTP. ה-HTTP Recurrest שראינו כבר באחד הסרטונים הקודמים, המטרה שלו זה לבקש דף.
01:25
אז אם אנחנו עובדים ב-Rest, אז עוד. אותו מסמך בדיוק של HTTP, המטרה שלו עכשיו תהיה לבקש מידע. כי אנחנו בונים וייב סרוויס, אנחנו מחצנים מידע, אז הלקוח שולח את המסמך הזה עם הבקשה של המידע.
01:40
מה השארת עושה? מחזיר HTTP response. אז ה-HTTP של הרספונס שהוא מחזיר, מחזיק בתוכו במקום דף HTML, את המידע שהלקוח רוצה.
01:52
במילים אחרות, rest משתתף. להשתמש בפרוטוקול HTTP בשביל לבקש מידע ולקבל את המידע. אז בואו נראה מבחינה סכמטית איך זה עובד. אז מה הפורמט של Rest Request?
02:06
הפורמט הוא בדיוק פורמט של HTTP Request, או ליתר דיוק מאוד דומה לפורמט הזה. יש לנו כאן את המתוד שאומר מה אנחנו בעצם רוצים, אנחנו רוצים לקבל מידע, אנחנו רוצים לשלוח מידע לשרת.
02:19
במקום הכתובת של הדף אינטרנט, יש לנו...