בדיקת RESTful Service עם Postman

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

מילון מושגים:

REST - סגנון לבניית ממשקי API מעל HTTP, המבוסס על משאבים ועל שיטות סטנדרטיות כמו GET ו-POST.

Postman - כלי לבדיקת API: שליחת בקשות HTTP לשרת ובחינת התגובות, נפוץ בפיתוח ובבדיקות.

GET - שיטת HTTP לבקשת מידע מהשרת בלי לשנות אותו. הפרמטרים מועברים בדרך כלל בכתובת.

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

PUT - שיטת HTTP לשליחת נתונים לשרת כדי ליצור או להחליף משאב קיים במלואו.

Localhost - שם המפנה למחשב המקומי עצמו (כתובת 127.0.0.1), המשמש לבדיקת שירותים הרצים על אותו מחשב.

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

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

בדיקת RESTful Service עם Postman

השיעור מציג את Postman, כלי שמאפשר לבדוק RESTful Service בשיטות שהדפדפן לא מסוגל להפעיל.

שימוש ב-Postman

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

2. בחירת פעולה וכתובת: בוחרים את ה-verb, כמו GET, POST, PUT, PATCH או DELETE, ורושמים את הכתובת, למשל http://localhost:3000/api/products.

3. כרטיסיות: לכל בקשה אפשר לפתוח כרטיסייה נפרדת, כך שלא צריך לכתוב את הכתובת מחדש.

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

למה לא דפדפן

5. שיטות: הדפדפן שולח GET בלבד כשמקלידים כתובת. Postman שולח POST, PUT, PATCH ו-DELETE, וכולל בהם תוכן בבקשה.

6. בקרה: ניתן לשמור את התשובה לקובץ, ולראות את פרטי הבקשה והתשובה בצורה מפורטת.

לבדיקה של RESTful Service, Postman נותן שליטה מלאה על הבקשה ועל התשובה, ולכן הוא הכלי המתאים.

השיעור הבא בקורס: חלוקה למודולים - קורס NodeJS

פרקי ההרצאה: בדיקת RESTful Service עם Postman

תמלול ההרצאה: בדיקת RESTful Service עם Postman

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

00:03
אז אחרי שבנינו איזשהו רסטפול סרוויס ממש פשוט שכל מה שהוא עשה רק החזיר את כל המוצרים שהיו לנו ואפשר להחזיר מוצר ספציפי לפי איי-די, הרצנו אותו מקודם ובדקנו אותו על ידי דפדפן.
00:18
אנחנו רוצים לבדוק אותו ולגלוש אליו על ידי תוכנה שהיא יותר מקצועית עבור בדיקות כאלה של רסטפול סרוויסס והתוכנה הזאת נקראת פוסטמן. יש כל מיני תוכנות ומערכות אחרות בשוק אבל אבל פוסטמן היא מאוד פופולרית והיא קלה לעבודה והייעוד שלה זה להוות עבורנו את ה-client side שבעצם גולש לשרת ובודק את כל הראוטס, שולח מידע, מקבל מידע בחזרה, רק בשביל לראות
00:47
שה-Restful Service שאנחנו בונים הוא כמו שצריך מבלי שנצטרך עכשיו ללכת ולבנות את כל האתר אינטרנט או קליינט שלם רק בשביל לבדוק שהכל עובד כמו שצריך.
00:58
אז בואו פשוט ניגש ונתקין פוסטמן. ניכנס לאינטרנט ונחפש פוסטמנט ודאונלוד. הנה יש לנו דאונלוד פוסטמנט אפ. פוסטמנט פעם הגיע כחרום אד-און כזה שבטח אפשר למצוא אותו פה ומאיזשהו שלב החרום אד-און כבר היה דפריקייטד והגיע חרום אפ שאנחנו צריכים פשוט להתקין.
01:26
גם אפשר לעבוד עם החרום אד-און זה ממש אותו הדבר. הנה יש לנו דאונלוד תורידו את זה לפי אם מערכת ההפעלה שלכם או 32 או 64, כנראה שאתם 64 וכבר המערכות ההפעלה החדשות.
01:39
בואו ניתן לו להתקין והוא סיים, נלחץ run והוא מתקין לנו כרגע את פוסטמן במחשב בפעם הראשונה. אז הנה ההתקנה מתחילה להתבצע ויש לנו כאן את פוסטמן.
01:58
אם יוצא לכם איזשהו מסך הרשמה כזה, מסך ראשוני של הרשמה, פשוט תלחצו אסקייפ או תלחצו על איקס או משהו כזה אם אתם לא רוצים להירשם ואתם גם כן יכולים להירשם אם אתם רוצים בכדי שהוא ייתן לכם יותר פיצ'רים.
02:16
מה אנחנו בעצם רואים כאן? בואו נסגור כאן את הכרטיסיית welcome הזאת. אנחנו רואים שיש לנו כאן את הכרטיסייה הזאת ואנחנו יכולים לפתוח כרטיסייה חדשה וכאן אנחנו רואים שיש לנו לבחור את ה-verb שאנחנו רוצים לבצע.
02:34
get, post, put, patch, delete או ורבים אחרים שיכולים להיות. כאן אנחנו רושמים לאן אנחנו רוצים לגלוש ופשוט מבצעים את הגלישה.
02:42
אז בואו נבחר get ובואו נגלוש ל-http://localhostport 3000/api/products וכמובן אנחנו רוצים גם לגשת לשרת שלנו ולהריץ אותו.