Спершу погляньмо, що кажуть самі творці Postman:
«Postman — потужний набір інструментів для тестування API, без яких багатьом розробникам уже не обійтися. Ми робимо чудові продукти, що допомагають створювати вражаючі API й працювати продуктивніше. Postman користується понад мільйон розробників у світі, і ця кількість постійно зростає. Ми плануємо розвивати й інші продукти, щоб дати розробникам найпотужніше рішення для створення та тестування API».
Нинішня версія Postman ще потужніша за старі, і чимало можливостей Pro тепер доступні безкоштовно. Ба більше, цей інструмент створили не лише для розробників. Навіть перевірка автоматичних відповідей не потребує особливих знань. Це дуже простий і водночас потужний інструмент.
Надіслати запит
Якщо відкрити цей набір, перейти до «Request Methods», а потім до «GET Requests», усі збережені дані зʼявляться в центральній частині вікна Postman. Тепер натисніть «Submit». Ви щойно надіслали свій перший запит і отримали першу відповідь.
Запити POST дещо складніші, але так само зрозумілі й послідовні. Цього разу ви скористаєтеся власним запитом. Натисніть плюс, щоб відкрити нову вкладку, змініть тип запиту з GET на POST і вкажіть https://jsonplaceholder.typicode.com/posts як адресу запиту. Це безкоштовна служба REST, яку можна використовувати для вигаданих даних. Вона дуже стає в пригоді для навчання, імітації роботи сервера й поширення прикладів коду.
Тепер потрібне тіло запиту POST. Натисніть «Body» під адресою запиту, змініть тип на «raw», а «Text» — на «JSON». Тепер вставте в редактор такий запит:
- {
- “title”: “My first POST request”,
- “body”: “Content of my first POST request!”,
- “userId”: 789
- }
Натисніть «send». Ви маєте отримати відповідь зі своїм текстом — підтвердження, що запит пройшов. Збережіть його на майбутнє. Можна також створити нову колекцію: просто натисніть «Save» праворуч від адреси запиту. Відкриється вікно збереження, де запитові можна дати імʼя та створити для нього нову колекцію.
Перевірки
Ще одна чудова можливість Postman — автоматичні перевірки запитів. Щойно ви створите перевірку для запиту, Postman перевірятиме кожну відповідь за вашими сценаріями. Погляньмо на простий приклад.
Додайте новий власний запит на отримання POST з https://jsonplaceholder.typicode.com/posts з ID = 6 і відкрийте вкладку «Tests». Праворуч у вікні Postman ви побачите перелік заготовок. Вони допоможуть скласти і першу перевірку, і другу, і всі наступні, бо цей код підходить для будь-чого — його треба лише трохи підправити під свої потреби.
tests[“Status code is 200”] = responseCode.code === 200;
- var jsonData = JSON.parse(responseBody);
- tests[“User ID is 1”] = jsonData.userId === 1;
- tests[“Post ID is 6”] = jsonData.id === 6;
- tests[“Body matches string”] = responseBody.has(“dolorem eum magni eos aperiam quia”);
- У першій перевірці подивимося, чи відповідь на наш запит повертає стан HTTP «200», чи ідентифікатор користувача дорівнює 1, ідентифікатор допису — 6 і чи є в тілі відповіді потрібний текст.
Тепер просто натисніть «Submit». Коли відповідь надійде, відкрийте вкладку «Tests» і перевірте, чи все пройдено.
Цією статтею ми хотіли показати, наскільки просто й приємно працювати з Postman!