Как отправить 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 в навык использования инструментов. Теперь не потеряется!