Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-21

1 Весь современный веб построен на использовании<a>API</a>, да и вообще бэкенд редко обходится без программных интерфейсов. При всём удобстве работы с ними, есть и небольшая сложность: под эти интерфейсы нужно создавать архитектуру и логику, писать документацию, тестировать и масштабировать их.

2 К счастью, есть много сервисов, призванных облегчить этот процесс. Один из них - Postman. О нём часто говорят исключительно как об инструменте тестирования API, но это далеко не всё, что умеет платформа.

3 Postman - это сервис для создания, тестирования, документирования, публикации и обслуживания API. Он позволяет создавать коллекции запросов к любому API, применять к ним разные окружения, настраивать мок-серверы, писать автотесты на <a>JavaScript</a>, анализировать и визуализировать результаты запросов.

4 Программа поддерживает разные виды архитектуры API:<a>HTTP</a>,<a>REST</a>, SOAP, GraphQL и WebSockets. Postman вовсю используют в Twitter, WhatsApp и Imgur, но благодаря удобному графическому интерфейсу разобраться в платформе может даже новичок.

5 Скачать Postman можно бесплатно<a>на официальном сайте</a>. Есть версии под Linux, Windows и macOS - правда, перед началом использования нужно зарегистрироваться.

6 Основная сущность в Postman -рабочее пространство(workspace). В бесплатной версии доступно три вида рабочих пространств:

7 <ul><li>личное - видно только владельцу;</li>

8 <li>командное - видно только членам команды, которые в нём работают;</li>

9 <li>публичное - доступно всем желающим.</li>

10 </ul>В Pro-версии появляется доступ к приватнымрабочим пространствам - такие пространства доступны не всем членам команды, а только приглашённым. В Enterprise-версии добавляютсяпартнёрские- они видны не только членам команды, но и приглашённым партнёрам.

11 Посмотрим, из чего состоит рабочее пространство Postman:

12 Скриншот: Postman / Skillbox MediaСамое интересное здесь - боковая панель слева. Семь её вкладок соответствуют основным инструментам Postman.

13 <ul><li>Collections.Здесь хранятся коллекции запросов к API. Несколько запросов внутри одной коллекции можно объединять в папки.</li>

14 <li>APIs.В этой вкладке можно хранить целые API: их определения и коллекции.</li>

15 <li>Environments.Здесь создаются и хранятся окружения, в которых лежат переменные. Активное окружение можно менять из любой вкладки в правом верхнем углу (где на скриншоте написано No Environment). Также тут можно создавать глобальные переменные, с которыми можно работать везде вне зависимости от окружения.</li>

16 <li>Mock Servers.Здесь можно создавать фиктивные серверы, которые имитируют поведение реальных. Это полезно при тестировании.</li>

17 <li>Monitors.Мониторы позволяют визуализировать и отслеживать работу API: следить за производительностью, проверять доступность и корректность работы сервера по расписанию, отправлять уведомления о сбоях.</li>

18 <li>Flows.Это инструмент, с помощью которого можно настроить логику API-приложений в визуальном редакторе. На март 2023 года он всё ещё доступен только в тестовом режиме, чтобы его использовать, придётся<a>отправить заявку</a>.</li>

19 <li>History.Здесь хранится история всех отправленных запросов. Их можно сохранять, объединять в коллекции, создавать для них документацию, мониторы и мок-серверы.</li>

20 </ul>Postman - популярный инструмент среди<a>тестировщиков</a>. Его можно использовать для написания запросов к любому API, даже если при их создании Postman никак не использовали.

21 У платформы есть и собственный<a>API</a>, на котором любой желающий может протестировать работу сервиса и разобраться в работе запросов. Этот эхо-сервер возвращает клиенту те же данные, которые тот ему прислал. Документацию к нему можно прочитать<a>здесь</a>.

22 Давайте попробуем написать собственный запрос к API и протестировать его работу.

23 Чтобы создать коллекцию, нужно перейти во вкладкуCollectionsи нажать плюс. В левой части приложения появится пунктNew Collection.

24 Скриншот: Postman / Skillbox MediaИзменим название на Test Collection. Для этого нажмём на три точки справа от New Collectionи во всплывающем окошке выберем пунктRename.

25 Скриншот: Postman / Skillbox MediaВ рабочей области коллекции есть пять вкладок:

26 <ul><li>Authorization.Здесь можно настроить метод и параметры авторизации, которые будут использоваться в каждом запросе внутри коллекции.</li>

27 <li>Pre-request Script. Здесь можно написать программу на JavaScript, которая будет выполняться перед каждой отправкой запроса внутри коллекции. Для наиболее распространённых алгоритмов Postman предлагает готовые сниппеты. Их можно использовать, чтобы не писать код с нуля.</li>

28 <li>Tests.Работает как Pre-request Script, но выполняет код после выполнения запроса. Именно этот раздел используют тестировщики для проверки API. Здесь тоже есть готовые сниппеты.</li>

29 <li>Variables.Здесь можно создать переменную и присвоить ей значение. Потом эту переменную можно использовать, указав её название в двойных фигурных скобках {{имя переменной}}.</li>

30 <li>Runs.Postman позволяет запускать запросы не по отдельности, а все сразу - внутри одной коллекции или папки. В разделе Runs хранится информация о таких прогонах и результатах их тестов.</li>

31 </ul>Создать запрос можно несколькими способами:

32 <ul><li>нажать в левом верхнем углу кнопкуNewи выбрать нужный тип запроса;</li>

33 <li>нажать на плюс на панели вкладок в верхней части приложения;</li>

34 <li>нажать на три точки возле названия коллекции и во всплывающем меню выбрать пунктAdd request.</li>

35 </ul>Если вы выбираете первый или второй способ, то при первом сохранении запроса нужно указать коллекцию, в которой тот будет храниться.

36 Напишем GET-запрос к <a>https://postman-echo.com</a>и назовём его Test GET (названия у запросов можно менять так же, как и у коллекций). Для этого:

37 <ul><li>Создадим новый запрос.</li>

38 <li>Выберем в нём метод GET.</li>

39 <li>Введём URL:<a>https://postman-echo.com/get/</a>.</li>

40 <li>В разделеParamsвведём ключи test_key1, test_key2 и значения test_value1, test_value2 соответственно.</li>

41 <li>Нажмём кнопкуSend.</li>

42 </ul>Скриншот: Postman / Skillbox MediaЭхо-сервер вернул нам JSON-файл с заголовками и аргументами, которые мы ему передали (некоторые заголовки Postman отправляет автоматически).

43 Также после получения ответа можно отдельно посмотреть cookies, заголовки и результаты тестов, если они были. Кроме того, Postman указывает статус ответа, скорость его получения и размер возвращённого файла.

44 Как и в случае с коллекциями, в запросах в Postman можно указывать метод и параметры авторизации, предзапросные скрипты и тесты.

45 Авторизация по умолчанию наследуется от коллекции, но её можно переопределить в запросе. Скрипты же выполняются полностью: как общие для коллекции, так и написанные специально для запроса.

46 Теперь напишем к нашему GET-запросу простой тест: проверку кода ответа. Если код ответа 200 (то есть запрос выполнен успешно) - тест пройден.

47 Для этого перейдём во вкладкуTestsи в правой колонке найдём сниппетStatus code: Code is 200. Нажмём на него - появится скрипт.

48 Скриншот: Postman / Skillbox MediaТеперь отправим запрос ещё раз. В поле ответа во вкладке Test Results появится отчёт о тесте: PASS (то есть пройден успешно).

49 Скриншот: Postman / Skillbox MediaТеперь напишем ещё два теста, но не внутри отдельного запроса, а внутри коллекции. Первый тест будет проверять, есть ли в теле ответа строка test_value2, второй - есть ли там строка string_you_want_to_search.

50 Перейдём к Test Collection, на вкладкуTests. Выберем сниппетResponse body: Contains stringи нажмём на него два раза. В первом блоке кода строку string_you_want_to_search заменим на test_value2, во втором оставим как есть. Не забудем сохранить изменения, чтобы новые тесты применились к запросу.

51 Скриншот: Postman / Skillbox MediaТеперь отправим к эхо-серверу тот же GET-запрос. Он должен пройти первый тест (потому что мы передавали test_value2 в качестве одного из значений) и не пройти второй. Посмотрим на результат.

52 Скриншот: Postman / Skillbox MediaВсё как мы и предполагали. К запросу применились как его собственные тесты, так и тесты всей коллекции, один из которых он не прошёл. Причём тесты коллекции выполнились первыми - до тестов самого запроса.

53 Порядок выполнения скриптов, написанных в разных местах коллекции, таков:

54 <ul><li>Сначала выполняются скрипты коллекции.</li>

55 <li>Затем скрипты папки (там их тоже можно писать).</li>

56 <li>И уже потом скрипты запроса.</li>

57 </ul>Это работает с любым кодом: как внутриTests, так и внутриPre-request Scripts.

58 Переменные, как и тесты, "живут" на разных уровнях Postman, и писать их можно в разных местах:

59 <ul><li>Глобальные переменныеприменяются ко всему рабочему пространству. Написать их можно во вкладкеEnvironmentsв разделеGlobals.</li>

60 <li>Переменные коллекциисоздаются внутри конкретной коллекции и работают только внутри неё.</li>

61 <li>Переменные окружениязадаются на уровне окружения во вкладкеEnvironments. Чтобы применить их к запросу, нужно напрямую связать его с окружением.</li>

62 <li>Локальные переменныесуществуют на уровне скриптов, которые выполняются при отправке запросов.</li>

63 <li>Переменные данныхвозникают, когда мы пользуемсяCollection Runner - инструментом для запуска сразу всех скриптов внутри коллекции или папки.</li>

64 </ul>Чем меньше область видимости переменной, тем выше её приоритет. То есть если где-то встретятся глобальная и локальная переменная с одинаковыми именами, то применится значение локальной переменной.

65 Создадим новое окружениеTest Environment - сделать это можно по аналогии с созданием коллекции, но только во вкладкеEnvironment.

66 Скриншот: Postman / Skillbox MediaСоздадим переменную test_variable и присвоим ей значение test_value3. Сохраним изменения в окружении.

67 Скриншот: Postman / Skillbox MediaЗатем перейдём к тестовой коллекции и применим к ней окружение, выбрав его в правом верхнем углу. Теперь мы можем использовать в этой коллекции все переменные окружения.

68 Скриншот: Postman / Skillbox MediaУсовершенствуем второй скрипт в тестах коллекции. Для этого строку "string_you_want_to_search" заменим на сниппетGet an environment variable. В нём variable_key заменим на название переменной test_variable. Сохраним изменения.

69 Таким образом, второй скрипт будет проверять, есть ли в ответе сервера соответствие не строке string_you_want_to_search, а содержимому переменной test_variable.

70 Скриншот: Postman / Skillbox MediaТеперь перейдём к GET-запросу и создадим новый параметр. Его ключом будет test_key3, значением - содержимое переменной test_variable. Для этого её название заключим в двойные фигурные скобки {{}}. Сохраним изменения и отправим запрос.

71 Скриншот: Postman / Skillbox MediaКак видим, все тесты пройдены. Значит, значение нашей переменной корректно извлекается и в параметрах запроса, и в тестах.

72 Скриншот: Postman / Skillbox MediaPostman - инструмент для работы API в течение всего его жизненного цикла. Но особенно часто им пользуются тестировщики из-за богатого инструментария запросов к API: в нём можно создавать и настраивать запросы, объединять их в коллекции и папки, применять к ним разные окружения со своими переменными, писать автотесты.

73 У Postman есть платные тарифы, но для начала работы, личных проектов и тестирования API подойдёт и бесплатная версия.