PracticU

התקנה ושימוש ב-Postman
לבדיקת ה-REST API

בלי כתוביותעם כתוביות
PracticU › קורס דוט-נט - NET Core. - עם Rest API › התקנה ושימוש ב-Postman לבדיקת ה-REST API
התקנה ושימוש ב-Postman לבדיקת ה-REST API
בהרצאה זו מתקינים ולומדים להשתמש בכלי Postman - התוכנה הנפוצה ביותר לבדיקת REST API, בלי להזדקק לדפדפן.
למה לא דפדפן
גלישה דרך דפדפן מראה רק את תוצאת ה-JSON, בלי פרטים נוספים כמו קוד הסטטוס, ה-Headers או ה-Body של הבקשה. חיסרון נוסף: הדפדפן יכול לייצר רק בקשות GET מתוך שורת הכתובת, ולכן לא מתאים לבדיקת בקשות POST, PUT, PATCH או DELETE.
השלבים העיקריים
1. התקנה והרשמה: מורידים ומתקינים את Postman מהאתר הרשמי, ונרשמים לחשבון חינמי כדי לקבל גישה לפיצ'רים נוספים.
2. הגדרה ראשונית: ב-Settings מסמנים Auto Save, כך ששינויים נשמרים אוטומטית בלי צורך בשמירה ידנית.
3. יצירת Collection: בונים New Collection (לדוגמה Countries REST API) - מבנה שמאפשר לבדוק API שלם. לכל נתיב מוסיפים Request נפרד, קובעים את ה-method (למשל GET) והכתובת (URL), ולוחצים Send כדי לראות את התגובה.
4. שכפול בקשות: אפשר לשכפל (Duplicate) בקשה קיימת וליצור ממנה בקשה נוספת לנתיב אחר (למשל "קבל מדינה לפי קוד" ו"קבל מדינה לפי שם"), כך שלא צריך לחזור כל פעם לדפדפן ולהחליף את הכתובת.
5. ביטול הדפדפן: ב-Launch Settings של הפרויקט אפשר להגדיר launchBrowser כ-false, כך שהרצת הפרויקט לא פותחת דפדפן בכלל, רק את הקונסול.
6. ייצוא וייבוא Collection: ברמת ה-Collection אפשר לבצע Export לשמירת כל ההגדרות כקובץ JSON (למשל בתוך תיקיית הפרויקט), ובהמשך Import כדי לשחזר אותן במחשב אחר או לשתף עם מתכנת אחר.
שימו לב
Postman הוא הכלי הפופולרי ביותר לבדיקת REST API, אך לא חייבים להשתמש בו - העיקרון הוא לבדוק את ה-API בעזרת כלי ייעודי שמדמה את הפרונטנד, ולא בעזרת דפדפן.
בסיום ההרצאה יודעים להתקין את Postman, לבנות בו Collection לבדיקת ה-REST API ולשמור ולשחזר אותו.

פרקי ההרצאה: התקנה ושימוש ב-Postman לבדיקת ה-REST API

  1. 00:00

    בדיקת REST API בדפדפן

  2. 00:36

    מגבלות הבדיקה בדפדפן

  3. 01:32

    התקנת Postman

  4. 02:34

    הגדרות Postman

  5. 03:10

    יצירת Collection

  6. 04:24

    שכפול בקשה ל-Get By Code

תמלול ההרצאה: התקנה ושימוש ב-Postman לבדיקת ה-REST API

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

  1. 00:02

    איך אנחנו בדקנו את ה-REST API והרצנו אותו? אז מה שעשינו זה פשוט Ctrl F5, והוא פתח לנו דפדפן, עם ה-Default Route פה, והדפדפן פשוט גלש ל-REST API, קיבל את התשובה, הציג אותה בגלל שזה JSON, אנחנו רואים את זה באחת מהדרכים להצגת JSON.

  2. 00:22

    האם אנחנו תמיד רוצים לבדוק את ה-REST API שלנו על ידי דפדפן? אז התשובה היא ממש לא. בדרך כלל לא בודקים REST API על ידי דפדפן. דבר ראשון, אולי אני רוצה לראות עוד נתונים לגבי מה קרה, אני רוצה לראות אולי את ה-status code שהוחזר, את ה-status text, אולי את ה-headerים, בדיוק את

  3. 00:41

    ה-body, אני רוצה לראות הרבה יותר דברים. ודבר שני, איך בדיוק אני אמור לבדוק post request, או put, או patch, או delete. הרסט-API שבנינו התעסק רק עם getים, רק עם get request, ולמעשה אני לא רוצה בכלל ברסט-API הזה להתעסק עם post או put.

  4. 00:59

    put או delete אז זה הספיק לי לבדוק אותו עם דוודפן בצורה כזאת. אבל בהמשך אנחנו כמובן נראה איך אנחנו עושים גם post וput וpatch וdelete אז אנחנו בכלל לא נצליח לבדוק את זה על ידי דוודפן כי כאשר אנחנו מבצעים גלישה עם דוודפן, כאן ב-URL הדוודפן עצמו תמיד מייצר get request ולא

  5. 01:20

    post ולא put ולא patch ולא delete. אז אנחנו רוצים לראות איך אפשר לבדוק את הרסט API שלנו על ידי מערכת אחרת והמערכת הכי פופולרית היום לבדיקת REST API נקראת Postman.

  6. 01:34

    זאת היא בעצם תוכנה שאנחנו צריכים להתקין. בואו נלך לגוגל, נחפש Postman, Download, הנה אנחנו רואים שיש לנו פה אפשרות to download, בואו נוריד את זה, ובואו נתקין, בואו נעצר Free Account.

  7. 01:51

    הסיבה שאנחנו רוצים להירשם זה כי בפוסטמן, אם אנחנו נרשמים אז אנחנו מקבלים יותר פיצ'רים. שאנחנו נצטרך להשתמש איתם בהמשך בואו ננסה סתם לזרוק פה practiceyou.gmail.com אולי ואיזושהי סיסמה stay sung in create an account בואו נראה אם הוא יסכים לנו ולא יבקש מאיתנו לאשר את זה אולי כל מיני כיש קושטים מה הוא רוצה

  8. 02:20

    ממני open postman בסדר מה הוא רוצה עכשיו your name בואו נזיור טוב, אנחנו, Backend Development כרגע, אפשר גם Full Stack, יש לו פה Full Stack, בואו נגיד לו שאנחנו Full Stackerים, יופי, Continue, הנה הוא פתח לנו פה את Postman, הדבר הראשון שאני רוצה לבצע בפוסטמן, זה ללכת ל-Settings,

  9. 02:46

    כאן גלגל שיניים, Settings, נגדול פה למטה, ולסמן Auto Save, זה אומר שאם אנחנו עושים איזה שהם שינויים, אז הם אוטומטית נשמרים, ולא צריך ללחוץ על Ctrl S או כל מיני קשקושים כאלה, בואו נסגור פה את כל אלה, נגדיל והנה יש לנו את Postman.

  10. 03:05

    מה שאנחנו רוצים לבצע זה לייצר משהו שנקרא Collection, אנחנו עוד נעבוד עם Postman הרבה אבל אנחנו רק רוצים לבצע דלישה ל-Rest API שלנו. מה שעושים זה יוצרים Collection, בואו נייצר פה New Collection, Blank.

  11. 03:22

    קודם כל את השם של ה-Collection זה יהיה Countries Rest API. מה זה בעצם Collection בפוסטמן? Collection מאפשר לבדוק REST API שלם. אז אנחנו יוצרים Collection שבודק את ה-Countries, אוסיפים Request, אנחנו רוצים to get all countries, הנה יש לנו פה את האפשרות להגיד איזה מתוד אנחנו רוצים, אנחנו רוצים את get, ופה אנחנו

  12. 03:48

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

  13. 04:05

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

  14. 04:24

    נבדוק את המערכת על ידי Postman, אז הנה Get All Countries עובד, אנחנו רוצים עוד Route, עוד Request, אז אפשר פשוט ללכת לשלוש נקודות ולבצע Duplicate.

  15. 04:38

    אז הוא משכפל את כל ההגדרות, נבחר את הכרטיסייה השנייה, ונגיד שאנחנו רוצים To Get Country By Code, נכון? זה בעצם ה-Route הבא שעשינו.

  16. 04:51

    אז אנחנו רוצים לגלוש

ההרצאה הקודמת: בעיות בניתובים - דוט נט NET Core.

ההרצאה הבאה: יצירת פרויקט REST API מלא - עבור חנות ספרים

הרצאות קשורות מקורסים אחרים

  • התקנה של פוסטמן - Postman
  • התקנת POSTMAN
  • הסבר על ארכיטקטורה REST
  • התקנה

קורסים נוספים במסלול

  • קורס Entity Framework Core - עבודה עם מסד נתונים בדוט-נט
  • קורס ASP.NET
  • קורס MVC
  • קורס Git ו-GitHub עם Visual Studio