PracticU

משתנים ב-Query
מול משתנים ב-Path

בלי כתוביותעם כתוביות
PracticU › קורס פוסטמן - Postman - בדיקות לאתרי אינטרנט - API › משתנים ב-Query מול משתנים ב-Path
מילון מושגים:
נתיב - מחרוזת שמתארת את מיקומו של קובץ או תיקייה במערכת הקבצים, או כתובת של משאב בתוך אתר.
Postman - כלי לבדיקת API: שליחת בקשות HTTP לשרת ובחינת התגובות, נפוץ בפיתוח ובבדיקות.
פרמטר - ערך שמועבר לפונקציה או לפקודה כקלט, ומשפיע על אופן פעולתן ועל התוצאה שהן מחזירות.
בקשה - פנייה שלקוח שולח לשרת כדי לקבל מידע או לבצע פעולה. השרת מחזיר עליה תגובה.
URL - הכתובת שמזהה משאב באינטרנט, למשל דף אתר, וכוללת פרוטוקול, שם מארח ונתיב.
GET - שיטת HTTP לבקשת מידע מהשרת בלי לשנות אותו. הפרמטרים מועברים בדרך כלל בכתובת.
Endpoint - נקודת קצה שאליה פונים ב-API, המזוהה בכתובת ומטפלת בסוג מסוים של בקשות. גם מכשיר קצה ברשת.
JSON - פורמט טקסט קריא לייצוג נתונים מובְנים כזוגות מפתח-ערך, נפוץ להחלפת מידע בין שרת ללקוח.
משתנים ב-Query מול משתנים ב-Path
בהרצאה בונים ב-Postman פרויקט קטן שמלמד את ההבדל בין שני סוגי פרמטרים בבקשות שנשלחות מהלקוח לשרת: path variable ו-query param.
השלבים העיקריים
1. יוצרים collection: על פי הדוקומנטציה של האתר פותחים workspace חדש, בוחרים create new collection ו-blank collection, ונותנים לו את שם ה-base URL.
2. מגדירים משתנה: ב-collection מגדירים variable בשם base url עם initial value ו-current value זהים. התוכן המשמעותי הוא ב-current value, וחשוב ללחוץ save כדי שאפשר יהיה להשתמש במשתנה.
3. בונים בקשה: יוצרים request בשם get product, כותבים סוגריים מסולסלים כפולים ו-Postman מציע את המשתנה. אחריו מוסיפים את ה-endpoint.
4. path variable: הוא חלק ממסלול ה-resource, מסומן בנקודתיים לפני שמו, ובדרך כלל הוא חובה. בלי מספר מוצר מתקבלת שגיאת bad request, ועם הערך הנכון חוזרת תשובה בפורמט JSON.
5. query param: מוסיפים אותו בטבלת ה-query params לפי שם הפרמטר בדוקומנטציה. הוא בא אחרי סימן שאלה, יכול להיות יותר מאחד, ובדרך כלל אינו חובה.
שימו לב
- בהעתקת שם פרמטר מהדוקומנטציה עלולה להיכנס גם ירידת שורה, וכדאי למחוק אותה.
- משתני הקולקשן מוכרים רק בקולקשן שלהם, ואילו משתנים מסומנים באות g הם גלובליים ומובנים ב-Postman.
אחרי ההרצאה אפשר לזהות בכתובת בקשה איזה חלק הוא path variable ואיזה query param, ולמלא אותם ב-Postman לפי הדוקומנטציה.
השיעור הבא בקורס: ההגיון העסקי העומד מאחורי עבודה עם ממשקים

פרקי ההרצאה: משתנים ב-Query מול משתנים ב-Path

  1. 00:00

    מבנה בקשות ווב

  2. 00:54

    יצירת Collection וקביעת Base URL

  3. 01:29

    יצירת Request מסוג Get Product

  4. 02:25

    Query Param מול Path Variable

  5. 03:00

    שליחת מוצר ספציפי ב-Path Variable

תמלול ההרצאה: משתנים ב-Query מול משתנים ב-Path

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

  1. 00:02

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

  2. 00:27

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

  3. 00:42

    אז יש לנו פה את ה-base URL הזה, אז בואו נלך, נעתיק את ה-base URL הזה, אמרנו שזה החלק הראשון של כל בקשה שנשלחת לשרת שקשור לאתר הזה.

  4. 00:54

    על מנת להתחיל לעבוד על פרויקט בפוסטמן, אנחנו נפתח workspace חדש ונלחץ פה על create new collection על הפלוס הזה. נבחר ב-blank collection אני נותן לו את השם של ה-url עצמו ה-base url והדבר הראשון שאני רוצה לעשות זה לקבוע variable שיהיה base url אני קובע initial value זהה לשני הסוגי שדות current value ו-initial value כאמור התוכן המשמעותי הוא ב-current value אחרי שקבענו

  5. 01:22

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

  6. 01:44

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

  7. 02:10

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

  8. 02:28

    יש לי את ה-query param ואת ה-path variable. path variable, כמו שאתם רואים, הוא חלק ממסלול הבקשה, והוא בדרך כלל, הוא בדרך כלל, אנחנו רואים אותו שהוא required, yes.

  9. 02:41

    אם אני רוצה להשתמש באיזשהו מוצר ספציפי, אני קודם כל צריך לראות שמות של מספרים של נוצרים, אז אני אשלח בקשה כללית ללא ה-query param, ואני רואה שלדוגמה יש לי מוצר שהוא 4,6,4,6 אז אני אוסיף את הפרודקט ID וב-path variable אני אקיש פה את המספר של המוצר הספציפי שאני רוצה להשתמש בו. אני אעשה save ואני אשלח אותו. אז אנחנו רואים ש-path variable

  10. 03:10

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

  11. 03:23

    אוקיי אני מקבל הודעת שגיאה bad request אז

לקורס המלא: קורס פוסטמן Postman לבדיקות API

ההרצאה הקודמת: שם משתנה בפוסטמן

ההרצאה הבאה: ההגיון העסקי העומד מאחורי עבודה עם ממשקים

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

  • משתנים
  • משתנים - חלק 1
  • הגדרת PATH
  • הוספת Query ל-Request

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

  • קורס מבוא ל-QA - מידע חשוב לבודק תוכנה
  • קורס Robot Framework - בדיקות QA ממשק גרפי
  • קורס יסודות התכנות - שפת JAVA - קורס ג'אווה למתחילים
  • קורס סלניום בסיסי - בדיקות אוטומטיות - Selenium
  • קורס סלניום מתקדם - CI/CD - Continues Integration
  • קורס מייבן - Maven