Postman Обучение

Что такое Postman?

Postman — масштабируемый инструмент тестирования API, который быстро интегрируется в конвейер непрерывной интеграции и непрерывной доставки (CI/CD). Он был запущен в 2012 году как сторонний проект Абхинава Астханы для упрощения рабочего процесса API при тестировании и разработке. API (Application Programming Interface) — это интерфейс прикладного программирования, позволяющий приложениям взаимодействовать друг с другом посредством вызовов API.

👉 Зарегистрируйтесь на бесплатный проект по живому тестированию API

Зачем использовать Postman?

Сегодня у нас более 4 миллионов пользователей. Postman Программное обеспечение стало предпочтительным инструментом по следующим причинам:

1. Доступность – Чтобы использовать Postman инструмент, нужно будет просто войти в свою учетную запись, что позволит легко получить доступ к файлам в любое время и в любом месте, если Postman приложение установлено на компьютер.
2. Использование коллекций – Postman позволяет пользователям создавать коллекции для своих Postman Вызовы API. Каждая коллекция может создавать подпапки и несколько запросов. Это помогает организовать ваши тестовые наборы.
3. Совместная работа — коллекции и среды можно импортировать и экспортировать, что упрощает обмен файлами. Для обмена коллекциями также можно использовать прямую ссылку.
4. Создание сред — наличие нескольких сред позволяет реже повторять тесты, поскольку можно использовать одну и ту же коллекцию, но для разных сред. Именно здесь будет происходить параметризация, о которой мы поговорим в следующих уроках.
5. Создание тестов — контрольные точки тестирования, такие как проверка успешного статуса ответа HTTP, можно добавить к каждому Postman Вызовы API, которые помогают обеспечить тестовое покрытие.
6. Автоматизированное тестирование. Благодаря использованию Collection Runner или Newman тесты можно запускать в несколько итераций, что экономит время на повторные тесты.
7. Отладка – Postman Консоль помогает проверить, какие данные были получены, что упрощает отладку тестов.
8. Непрерывная интеграция – Благодаря способности поддерживать непрерывную интеграцию сохраняются методы разработки.

Как это работает? Postman для выполнения API

Ниже приведена Postman Рабочее пространство. Давайте рассмотрим пошаговый процесс Как это работает? Postman и различные особенности Postman инструмент!

1. Новый — здесь вы создадите новый запрос, коллекцию или среду.
2. Импорт – используется для импорта коллекции или среды. Доступны такие варианты, как импорт из файла, папки, ссылки или вставка необработанного текста.
3. Runner — тесты автоматизации можно выполнять с помощью Collection Runner. Подробнее об этом пойдет речь на следующем уроке.
4. Открыть новую – открыть новую вкладку, Postman Окно или Окно бегунка, нажав эту кнопку.
5. Мое рабочее пространство. Вы можете создать новое рабочее пространство индивидуально или в команде.
6. Пригласить — сотрудничайте в рабочей области, приглашая членов команды.
7. История — отправленные вами прошлые запросы будут отображаться в истории. Это позволяет легко отслеживать действия, которые вы совершили.
8. Коллекции — организуйте свой набор тестов, создавая коллекции. Каждая коллекция может содержать подпапки и несколько запросов. Запрос или папка также могут быть дублированы.
9. Вкладка «Запрос» — здесь отображается заголовок запроса, над которым вы работаете. По умолчанию для запросов без заголовков будет отображаться «Запрос без названия».
10. HTTP-запрос – при нажатии на эту ссылку откроется раскрывающийся список различных запросов, таких как GET, POST, COPY, DELETE и т. д. В Postman Тестирование API, наиболее часто используемые запросы — GET и POST.
11. URL-адрес запроса — также известный как конечная точка. Здесь вы определяете ссылку, с которой будет взаимодействовать API.
12. Сохранить. Если в запросе есть изменения, необходимо нажать «Сохранить», чтобы новые изменения не были потеряны или перезаписаны.
13. Параметры — здесь вы можете записать параметры, необходимые для запроса, например, ключевые значения.
14. Авторизация — для доступа к API требуется соответствующая авторизация. Она может быть выполнена с помощью имени пользователя и пароля, токена на предъявителя и т. д.
15. Заголовки — вы можете задать заголовки, например тип контента JSON, в зависимости от потребностей организации.
16. Тело — здесь можно настроить детали запроса, обычно используется в запросе POST.
17. Сценарий предварительного запроса. Это сценарии, которые будут выполняться перед запросом. Обычно сценарии предварительного запроса для среды настройки используются, чтобы гарантировать, что тесты будут выполняться в правильной среде.
18. Тесты — это скрипты, выполняемые во время запроса. Важно иметь тесты, поскольку они устанавливают контрольные точки для проверки корректности ответа, соответствия полученных данных ожидаемым и других тестов.

Работа с GET-запросами

Запросы Get используются для получения информации по указанному URL. В конечную точку не вносятся никакие изменения.

Мы будем использовать следующий URL для всех примеров в этом документе. Postman учебник https://jsonplaceholder.typicode.com/users

В рабочей области

1. Установите для HTTP-запроса значение GET.
2. В поле URL запроса введите ссылку
3. Нажмите Отправить
4. Вы увидите сообщение «200 OK».
5. В теле должно быть 10 результатов пользователей, что означает, что ваш тест выполнен успешно.

*Заметка: Могут быть случаи, когда Get Postman Запрос может быть невыполнен. Это может быть связано с недействительным URL-адресом запроса или необходимостью аутентификации.

Работа с POST-запросами

Запросы POST отличаются от запросов GET тем, что пользователь, добавляя данные в конечную точку, манипулирует данными. Используя те же данные из предыдущего урока по запросу GET, давайте добавим своего пользователя.

Шаг 1) Откройте новую вкладку, чтобы создать новый запрос.

Шаг 2) В новой вкладке

1. Установите для HTTP-запроса значение POST.
2. Введите ту же ссылку в URL-адрес запроса: https://jsonplaceholder.typicode.com/users
3. переключитесь на вкладку «Тело»

Шаг 3) В теле,

1. Нажмите сырой
2. Выберите JSON

Шаг 4) Скопируйте и вставьте только один результат пользователя из предыдущего запроса на получение, как показано ниже. Убедитесь, что код скопирован правильно с помощью парных фигурных скобок и квадратных скобок. Измените идентификатор на 11 и укажите любое желаемое имя. Вы также можете изменить другие данные, например адрес.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

*Заметка: Запрос на онлайн-публикацию должен иметь правильный формат, чтобы гарантировать создание запрашиваемых данных. Рекомендуется использовать Get first для проверки формата JSON запроса. Вы можете использовать такие инструменты, как https://jsonformatter.curiousconcept.com/

Шаг 5) Далее

1. Нажмите Отправить.
2. Статус: 201 Создано, должен отображаться
3. Опубликованные данные отображаются в теле сообщения.

Как параметризовать запросы

Параметризация данных — одна из наиболее полезных функций PostmanВместо создания одинаковых запросов с разными данными можно использовать переменные с параметрами. Эти данные могут быть взяты из файла данных или переменной окружения. Параметризация помогает избежать повторения одних и тех же тестов, а итерации можно использовать для автоматизация тестирования.

Параметры создаются с помощью двойных фигурных скобок: {{sample}}. Давайте рассмотрим пример использования параметров в нашем предыдущем запросе:

Теперь давайте создадим параметризованный GET-запрос.

Шаг 1)

1. Установите для HTTP-запроса значение GET.
2. Введите эту ссылку: https://jsonplaceholder.typicode.com/users. Замените первую часть ссылки таким параметром, как {{url}}. URL-адрес запроса теперь должен быть {{url}}/users.
3. Нажмите отправить.

Ответа быть не должно, поскольку мы не установили источник нашего параметра.

Шаг 2) Для использования параметра необходимо настроить среду

1. Нажмите на значок глаза
2. Нажмите «Изменить», чтобы задать для переменной глобальную среду, которую можно использовать во всех коллекциях.

Шаг 3) В переменной,

1. установите имя для URL-адреса https://jsonplaceholder.typicode.com
2. нажмите Сохранить.

Шаг 4) Нажмите «Закрыть», если увидите следующий экран.

Шаг 5) Вернитесь к запросу Get и нажмите «Отправить». Результаты по вашему запросу должны быть готовы.

*Заметка: Всегда проверяйте, чтобы ваши параметры имели источник, например переменную среды или файл данных, чтобы избежать ошибок.

Как создать Postman Tests

Postman Тесты JavaКоды скриптов, добавляемые к запросам, которые помогают проверить результаты, такие как статус успешного или неудачного выполнения, сравнение ожидаемых результатов и т. д. Обычно начинается с pm.test. Его можно сравнить с командами assert и verify, доступными в других инструментах.

Давайте сделаем некоторые базовые API тестирование через Postman для наших параметризованных запросов из предыдущего урока.

Шаг 1) Перейдите к пользовательскому запросу GET из предыдущего руководства.

1. Перейдите на вкладку тестов. Справа находятся фрагменты кодов.
2. В разделе фрагментов нажмите «Код состояния: код 200».

Панель заполняется автоматически

Шаг 2) Теперь нажмите Отправить. Теперь должен отобразиться результат теста.

Шаг 3) Вернитесь на вкладку тестов и добавим еще один тест. На этот раз мы сравним ожидаемый результат с фактическим результатом.

В разделе фрагментов нажмите «Тело ответа: проверка значения JSON». Мы проверим, имеет ли Линн Грэм идентификатор пользователя 1.

Шаг 4)

1. Замените «Имя вашего теста» в коде на «Проверьте, является ли пользователь с идентификатором 1 Линн Грэм», чтобы имя теста точно указывало, что мы хотим протестировать.
2. Замените jsonData.value на jsonData[0].name. Чтобы получить путь, проверьте тело в методе Get result, описанном ранее. Поскольку идентификатор пользователя Лианн Грэм равен 1, jsonData находится в первом результате, который должен начинаться с 0. Чтобы получить второй результат, используйте jsonData[1] и так далее для последующих результатов.
3. В eql введите «Линн Грэм».

pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Шаг 5) Нажмите «Отправить». Теперь по вашему запросу должно быть два пройденных результата теста.

*Заметка: Существуют различные виды тестов, которые можно создавать в Postman. Попробуйте изучить этот инструмент и посмотреть, какие тесты подойдут вашим потребностям.

Как создавать коллекции

Коллекции играют важную роль в организации тестовых наборов. Их можно импортировать и экспортировать, что упрощает совместное использование коллекций внутри команды. В этом руководстве мы научимся создавать и выполнять коллекции.

Приступим к созданию коллекции:

Шаг 1) Нажмите кнопку «Новый» в левом верхнем углу страницы.

Шаг 2) Выберите Коллекция. Должно появиться окно создания коллекции.

Шаг 3) Введите желаемое имя и описание коллекции, затем нажмите «Создать». Теперь должна быть создана коллекция.

Шаг 4) Вернитесь к предыдущему запросу Get. Нажмите «Сохранить».

Шаг 5)

1. Выберите Postman Тестовый сборник.
2. Щелкните Сохранить в Postman Тестовая коллекция

Шаг 6) Postman тестовая коллекция теперь должна содержать один запрос.

Шаг 7) Повторите шаги 4–5 для предыдущего запроса Post, чтобы в коллекции теперь было два запроса.

Как запускать коллекции с помощью Collection Runner

Существует два способа запуска коллекции: Collection Runner и Newman. Начнем с выполнения коллекции в Collection Runner.

Шаг 1) Нажмите кнопку «Бегущий» в верхней части страницы рядом с кнопкой «Импорт».

Шаг 2) Страница Collection Runner должна выглядеть так, как показано ниже. Ниже приводится описание различных полей.

Шаг 3) Запустите свой Postman Протестируйте сбор, выполнив следующие настройки:

• Выберите Postman тестовая коллекция. Установите итерации как 3.
• Установите задержку 2500 мс.
• Нажмите «Выполнить». Postman Кнопка «Проверить…»

Шаг 4) Страница результатов запуска должна отображаться после нажатия кнопки «Выполнить». В зависимости от задержки вы должны видеть тесты по мере их выполнения.

1. После завершения тестов вы можете увидеть статус теста (пройден или не пройден), а также результаты за итерацию.
2. Вы увидите статус «Пройдено» для запросов на получение.
3. Поскольку никаких тестов для Post у нас не было, то должно появиться сообщение, что в запросе нет тестов.

Вы можете видеть, насколько важно, чтобы в ваших запросах были тесты, чтобы вы могли проверить статус HTTP-запроса в случае его успеха, а также создания или получения данных.

Как запускать коллекции с помощью Newman

Другой способ запустить коллекцию — через Newman. Основные различия между Newman и Collection Runner заключаются в следующем:

1. Newman — это дополнение к Postman. Вам нужно будет установить его отдельно от собственного приложения.
2. Ньюман использует командную строку, а Collection Runner имеет графический интерфейс.
3. Newman можно использовать для непрерывной интеграции.

Чтобы установить Newman и запустить из него нашу коллекцию, сделайте следующее:

Шаг 1) Установите nodejs, используя эту ссылку: http://nodejs.org/download/

Шаг 2) Откройте командную строку и введите

 npm install -g newman

Теперь Newman должен быть установлен на вашем компьютере.

Шаг 3) После установки Newman вернемся к нашему Postman workspace.В поле Collections нажмите на три точки. Теперь должны появиться параметры. Выберите Export.

Шаг 4) Выберите «Экспортировать коллекцию» как «Коллекцию v2.1 (рекомендуется)», затем нажмите «Экспорт».

Шаг 5) Выберите желаемое местоположение и нажмите «Сохранить». Желательно создать отдельную папку для вашего Postman тесты. Теперь коллекция должна быть экспортирована в выбранный вами локальный каталог.

Шаг 6) Нам также потребуется экспортировать нашу окружающую среду. Нажмите на значок глаза рядом с раскрывающимся списком среды в разделе «Глобальные», выберите «Загрузить как JSON». Выберите желаемое местоположение и нажмите «Сохранить». Желательно, чтобы среда находилась в той же папке, что и ваша коллекция.

Шаг 7) Теперь среду следует экспортировать в тот же локальный каталог, что и коллекцию.

Шаг 8) Теперь вернитесь в командную строку и измените каталог на тот, в котором вы сохранили коллекцию и среду.

 cd C:\Users\Asus\Desktop\Postman Tutorial

Шаг 9) Запустите свою коллекцию с помощью этой команды:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Результаты запуска теперь должны выглядеть так, как показано ниже.

В качестве руководства приведена ссылка на некоторые основные коды Ньюмана для выполнения:

1. Запуск только коллекции. Это можно использовать, если нет зависимости от среды или файла тестовых данных.

newman run <collection name>

2. Запустите коллекцию и среду. Индикатор -e предназначен для окружающей среды.

newman run <collection name> -e <environment name>

3. Запустите сбор с желаемым номером. итераций.

newman run <collection name> -n <no.of iterations>

4. Запустить с файлом данных.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

5. Установите время задержки. Это важно, поскольку тесты могут завершиться неудачей, если они выполняются без задержки из-за того, что запросы запускаются без завершения обработки предыдущего запроса на сервере конечной точки.

newman run <collection name> -d <delay time>

Наша команда Postman руководство по вопросам на собеседовании поможет вам успешно пройти собеседование и получить работу мечты в области тестирования программного обеспечения.

Общий Postman Сценарии устранения неполадок

1. Ошибки 401 «Несанкционированный доступ» или 403 «Запрещенный доступ»

   Это происходит, когда в вашем запросе отсутствуют действительные учетные данные аутентификации.
   Как исправить: DoubleПроверьте тип авторизации (API Key, Bearer Token или Basic Auth). Если вы используете токены, убедитесь, что их срок действия не истёк. При необходимости сгенерируйте новые токены или обновите учётные данные сеанса.

2. 400 Bad Request

   Эта ошибка возникает, если синтаксис или параметры запроса неверны.
   Как исправить: Проверьте тело JSON или XML с помощью инструмента форматирования, например JSONLint. Убедитесь, что ваши параметры точно соответствуют ожиданиям API, включая чувствительность к регистру и тип данных.

3. 500 внутренняя ошибка сервера

   Обычно это проблема бэкэнда, но может также возникнуть, если полезная нагрузка не структурирована должным образом.
   Как исправить: Повторите запрос, используя допустимые форматы данных. RevПеред повторной отправкой запроса просмотрите документацию API для определения правильных схем.

4. Тайм-аут запроса (408)

   Возникает, когда сервер слишком долго отвечает.
   Как исправить: Проверьте подключение к Интернету и убедитесь, что URL-адрес конечной точки доступен. Попробуйте отправлять меньшие объёмы данных или измените время ожидания в Postman если доступно.

5. Переменные среды не работают

   Переменные могут работать неправильно, если они не определены или имеют неправильную область действия.
   Как исправить: Нажмите на значок глаза рядом с селектором окружения, чтобы просмотреть определённые переменные. Убедитесь, что вы используете правильное окружение (Global, Environment или Collection).

6. Тесты неожиданно провалились

   Если тестовые сценарии ведут себя не так, как ожидалось, это часто означает логическую или синтаксическую ошибку.
   Как исправить: Используйте console.log() для вывода промежуточных результатов и отладки скрипта. Убедитесь, что вы правильно ссылаетесь на данные ответа с помощью pm.response.json().

7. Неправильные заголовки или тип контента

   Неправильные заголовки могут привести к отклонению сервером или ошибкам несоответствия данных.
   Как исправить: При отправке JSON-данных всегда указывайте Content-Type как application/json. Удаляйте дублирующиеся или конфликтующие заголовки.

8. Сборщик не показывает результаты теста

   Это происходит, когда ваши тестовые сценарии не содержат операторов pm.test().
   Как исправить: Добавьте соответствующие тестовые сценарии, такие как:

   pm.test("Status code is 200", function () {
     pm.response.to.have.status(200);
   });
   

   Это гарантирует, что Collection Runner фиксирует и сообщает результаты тестирования.

9. Ньюман не проводит тесты

   Если Newman выдает ошибки, это может быть связано с неправильными путями к файлам или устаревшими версиями.
   Как исправить: Обновите Newman, выполнив команду npm install -g newman. Убедитесь, что файлы коллекции и окружения .json находятся по правильным путям.

10. Медленный ответ или запаздывающие запросы

    Большие объемы полезной нагрузки или задержки на внутреннем уровне могут замедлить ваши тесты.
    Как исправить: Используйте пагинацию или меньшие наборы данных. Включите Postman Консоль для измерения времени отклика и выявления медленных конечных точек.

лучшие практики для плавности Postman Тестирование

1. Используйте окружения и переменные с умом

Создавайте отдельные среды для разработки, контроля качества и производства. Храните базовые URL-адреса, ключи API и токены в переменных, а не жёстко прописывайте их в коде. Это обеспечивает бесперебойное переключение между средами.

2. Организация коллекций и рабочих пространств

Сохраняйте модульность своих коллекций — группируйте запросы по модулям API. Например, «Управление пользователями», «Аутентификация» или «Заказы». Используйте описательные названия запросов для упрощения совместной работы.

3. Контролируйте версии своих коллекций

Сохраняйте свои коллекции в Postman Облако или экспортируйте их в Git. Это обеспечивает резервное копирование, отслеживание версий и упрощает командную работу.

4. Пишите понятные и не требующие объяснений тесты.

Сохраняйте тестовые утверждения читабельными. Например:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

Это улучшает читаемость теста и ясность отладки.

5. Автоматизация с помощью скриптов предварительного запроса

Используйте скрипты Pre-Request для генерации временных меток, вычисления подписей или динамического извлечения токенов перед выполнением запроса. Это сводит к минимуму необходимость ручных обновлений.

6. Регулярно контролируйте API

Создавать Postman Мониторы для автоматического запуска тестов через регулярные интервалы. Они оповещают вас о сбоях API или падении производительности.

7. Содержите рабочее место в чистоте

Удалите устаревшие среды, переменные и коллекции. Аккуратное рабочее пространство предотвращает путаницу и случайные запуски тестов на устаревших конечных точках.

8. Повторно используйте общие фрагменты кода

Вместо того чтобы писать одни и те же утверждения повторно, сохраните повторно используемые фрагменты для заголовков, проверки текста и валидации ответов.

9. Интеграция с CI/CD с помощью Newman

Используйте Newman для автоматизации тестов в Jenkins, GitHub Actions или Azure Pipelines. Обеспечивает тестирование ваших API перед каждым развертыванием.

10. Документируйте все

Postman Позволяет автоматически создавать и распространять документацию. Обновлённые документы не только улучшают взаимодействие в команде, но и повышают узнаваемость LLM для вашего бренда.

Советы по быстрой отладке

• Откройте приложение Postman Консоли (Ctrl + Alt + C) для просмотра журналов и запроса подробностей.
• Использовать Функция прокси для захвата мобильного или локального трафика API.
• Перед отправкой запросов проверяйте полезную нагрузку.
• Помните: имена заголовков в Postman с учетом регистра.
• If Postman ведет себя нестабильно, очистите кэш или перезапустите приложение.

Совет эксперта: Всегда начинайте с простого. Сначала отправьте простой GET-запрос и подтвердите подключение. Затем постепенно добавляйте заголовки, тело и тесты. Пошаговая отладка быстрее, чем анализ перегруженного, невыполняющегося запроса.

FAQ