לפני שנצלול פה לתוכן פרקטי על מערכת POSTMAN, אם המושגים כאן קצת גבוהים לכם אני ממליץ להתחיל מהמאמר "מה זה וובהוק", ולהציץ גם במדריך על MAKE
אוקיי, אפשר להמשיך:
מהי מערכת POSTMAN?
המערכת הפשוטה להפליא הזאת מאפשרת לנו לשלוח דאטא לכתובת וובהוק שאנחנו משתמשים בו בתהליך אוטומציה שבנינו (לצורך העניין ב-MAKR או ZAPIER).
הממשק הידידותי של POSTMAN מאפשר לאנשי אוטומציה לשלוח קריאות API, במגוון מבנים ולוודא שהתהליך עובד בצורה טובה.
יתרונות לשימוש במערכת POSTMAN
- לא צריך להפעיל את הטריגר המקורי (חסכון בזמן ובדאטא מיותרת)
- תיעוד מסודר של קריאות ה-API
- שליחת הוובהוק מתבצעת באופן מיידי
- אפשר לשלוח את ה-API גם בפורמט JSON וגם בפורמט של פרמטרים וערכים.
- השימוש במערכת הוא בחינם
דוגמא לשימוש ב-POSTMAN
ניקח דוגמא קלאסית לשימוש בממשק:
נגיד בנינו תהליך אוטומציה שבו אנחנו רוצים למשוך נתונים על סליקות ממערכת קארדקום לגוגל שיטס.
כביכול כדי לעשות טסט שסליקה עוברת כמו שצריך אנחנו נצטרך לבצע תשלום בדף של קארדקום (או להגדיר שם "הסתר פרטי אשראי בסכום 0", אבל עדיין נצטרך למלא כל פעם את דף התשלום)
כל נסיון כזה לוקח זמן, ובנוסף הלקוח יקבל מייל מקארדקום ותצא חשבונית על סכום 0.
כדי להימנע מכל אלה אנחנו נשים את אותו הוובהוק ששתלנו בקארדקום בתוך POSTMAN, נבנה קריאת API פשוטה עם הפרמטרים שמעניינים אותנו (שם הלקוח, מייל, טלפון, שם המוצר, סכום וכו') ונשלח בקליק אחד לווובהוק שלנו.
וככה נוכל לעשות כמה טסטים שרק נרצה במקום למלא כל פעם מחדש את דף התשלום.
איך משתמשים במערכת POSTMAN?
- פותחים חשבון בחינם ב-POSTMAN
- יוצרים סנריו במערכת MAKE עם טריגר של וובהוק
- נכנסים ל-POSTMAN ופותחים WORSPACE חדש
- מעתיקים את כתובת הוובהוק ומסמנים "POST"
- כותבים בטבלה את הפרמטרים והערכים שרוצים לשגר לוובהוק (אם יש צורך אפשר לכתוב גם Headers)
- עושים לוובהוק ב-MAKE הרצה (כפתור ימיני על הוובהוק ו-RUN)
- מקבלים מיידית את הקריאה ואפשר להמשיך את הסנריו
ככה זה נראה מתוך הממשק:
הדוגמא שנתתי היא על שליחת פרמטרים, אפשר כמובן לשלוח גם קריאה במודל JSON:
איך שולחים מערך ARRAY בעזרת POSTMAN?
במידה ורוצים לשלוח מערך ARRAY (כמות רשומות בתוך אחד הפרמטרים), נכתוב את הערך עם הסימון "[]", ובתוך הסוגריים את המספר הסידורי. ככה זה נראה:
לסיכום
הממשק הידידותי של POSTMAN מאפשר לעשות לנו בדיקות זריזות לתהליכים אוטומציה שבנינו שמתחילים עם וובהוק, כתחליף להטרגה של הטריגר המקורי. ככה אנחנו יכולים לבנות ולשדרג את האוטומציות שלנו בצורה מהירה ויעילה.
כמו תמיד, מוזמנים לשאול כאן בתגובות שאלות וכמובן גם פרגונים יתקבלו בברכה!