понедельник, 15 октября 2018 г.

Как отправить REST-запрос в Postman

Если вы никогда раньше не слышали про REST-запросы, то вам сюда ツ

Давайте рассмотрим на примере, который вы можете прямо сейчас взять и повторить. Показывать я буду на системе Users, которая находится в открытом доступе. А запросы будем посылать через бесплатный инструмент Postman.


Отправить первый запроса с нуля


Отправлять мы будем запрос doRegister

REST отличается от SOAP-а тем, что тут необязательно должен быть контракт (WADL). И если его нет, то без документации вы запрос не отправите. Попробуем с документацией!

1. Запустить Postman — он сразу откроет окно ввода запроса. Слева отображается история выполненных ранее запросов. Исходно она пуста, но скоро заполнится =)




2. Тип метода — POST 

Это написано в документации в плашке. И вообще в Users все методы — POST.



3. URL метода — http://users.bugred.ru/tasks/rest/doregister

Он есть в документации. Но хотя в документации описаны не все методы, их список есть по ссылке http://users.bugred.ru/tasks/rest/list, оттуда и брали URL для ТЗ. Если у вас нет WADL, то просите хотя бы такую ссылку с названиями всех методов


4. Тело запроса: Body — form-data

Смотрим в ТЗ, какие поля надо заполнить, их и передаем.

  • Key — имя параметра
  • Value — значение.


Например:

  • email — test_blog@gmail.com
  • name — Блоггер
  • password — 1


5. Все, отправляем запрос — большая кнопка Send

Снизу видим ответ, ошибку или данные по созданному клиенту. В нашем случае все прошло хорошо!


Профит! Мы отправили первый запрос за пару минут. Postman и тот дольше скачивали! ツ

См также:
Освоение тестирования REST API — еще про рест
Как отправить SOAP-запрос в Soap Ui — аналогичная статья про SOAP-запросы


А от меня еще пара заметок по инструменту из серии HOWTO



Указать заголовки


Если нужно передать заголовки, перейдите на вкладку Headers рядом с Body.
В Users обязательных заголовков нет (в большинстве методов), поэтому мы этот шаг пропускали.


Если от пользователя не нужны заголовки — значит, система сама их назначает стандартными или теми, которые разработчик зашил в коде. А так то заголовки всегда есть, они как минимум говорят о том, что за метод мы вообще передаем.



Авторизоваться


Авторизация передается или в заголовке в виде токена, или на отдельной вкладке



Сохранить запрос


Любой запрос можно сохранить, для этого тыкните на кнопку Save:




Система предложит выбрать коллекцию для сохранения или создать новую. Потом все сохраненные запросы будут доступны на вкладке Collections


Очень удобно, чтобы не писать запрос с нуля каждый раз или не бегать искать его по History


Клонировать запрос


Тыкнуть на запрос — Ctrl + D.
Или нажать на многоточие справа от названия — Duplicate.

Создать новый запрос


Просто нажать на плюсик около вашей вкладки



Домашнее задание


Попробуйте создать пользователя в Users через REST! Или поисследуйте другие REST-методы приложения, это придаст уверенности в своих знаниях =) 

PS — статья написана в помощь студентам моего курса «Тестирование REST API»

Добавлена на Testbase в навык использования инструментов. Теперь не потеряется!

Комментариев нет:

Отправить комментарий