Коллекция и окружение Postman импортируются в PolyApiIDE на бесплатном тарифе: запросы, папки и переменные переезжают файлом, а что требует ручной правки — перечислено ниже без умолчаний.
Переход с одного клиента на другой обычно спотыкается не на импорте, а на ожиданиях: кажется, что переедет всё, включая скрипты и привычные кнопки. Поэтому сразу разделим: транспортная часть переносится файлом, а логика на JavaScript из Postman требует внимания.
PolyApiIDE читает Postman Collection v2.1 и файл окружения (environment). Запросы, папки, методы, адреса, параметры, заголовки и тела приходят вместе с коллекцией, переменные — отдельным файлом окружения. Синтаксис переменных у обоих клиентов один и тот же, {{var}}, так что адреса и заголовки после импорта остаются рабочими.
Если команда разъехалась по разным инструментам, импорт не ограничен Postman: поддерживаются также Insomnia, Hoppscotch, Thunder Client, отдельные curl-команды, а из спецификаций — OpenAPI в JSON и YAML, WSDL, GraphQL SDL и introspection, .proto и AsyncAPI. Всё перечисленное входит в бесплатный тариф; платным остаётся режим патчей коллекций.
В списке коллекций откройте меню нужной коллекции, выберите Export и формат Collection v2.1 — он помечен как рекомендуемый. Получится один JSON-файл.
Окружения экспортируются отдельно, в разделе Environments, тоже в JSON. Без этого файла переменные не переедут, и запросы приедут с нераскрытыми {{var}}.
Откройте PolyApiIDE и загрузите сначала коллекцию, затем окружение. Регистрация для этого не нужна: импорт работает на Free. Если хочется сначала потренироваться, готовые файлы-примеры лежат на странице примеров.
Экспорт Postman не всегда выносит значения секретных переменных, а токены доступа в принципе стоит получить заново. Пройдитесь по окружению и заполните пустые значения — помните, что пустое значение в иерархии не применяется и не затирает нижний уровень.
Возьмите по одному запросу из каждой папки и отправьте. Это быстрее, чем вычитывать импортированное дерево глазами, и сразу показывает незаполненные переменные и забытую авторизацию.
| Элемент Postman | Перенос | Комментарий |
|---|---|---|
| Запросы, папки, методы, адреса | Да | Из файла Collection v2.1 |
| Заголовки, параметры, тело запроса | Да | Включая переменные в формате {{var}} |
| Переменные окружения | Да | Отдельным файлом environment |
| Секретные значения и токены | Частично | Экспорт может их не содержать — заполните вручную |
| Pre-request и test-скрипты на pm | Нет | API отличается, логику переносят на poly / pm вручную |
| Мониторы, моки, Flows | Нет | Это сервисы облака Postman, а не часть коллекции |
| История, комментарии, командные рабочие области | Нет | Остаются в Postman |
Сознательно не обещаем автоматический перенос скриптов: в PolyApiIDE свой набор функций для pre-request и after-response, с автодополнением в редакторе, и переписанный шаг обычно оказывается короче исходного.
Нет. Импорт коллекции Postman и файла окружения работает на Free, аккаунт на сайте для этого не требуется. Платным остаётся режим патчей коллекций.
Ориентируйтесь на Collection v2.1 — это текущий рекомендуемый формат экспорта в самом Postman. Старую коллекцию проще сначала открыть в Postman и выгрузить заново в v2.1.
Один-в-один они не исполняются: набор функций отличается. Простые проверки статуса, задержки, вхождения подстроки и JSON path обычно вообще не требуют кода — они настраиваются как QA-проверки на уровне запроса.
После импорта коллекции лежат локально в браузере. В облако что-либо уходит только по вашей команде — ручным экспортом, патчем или снапшотом. Realtime-синхронизации рабочей области нет.
Да, если это обычный файл Collection v2.1 — происхождение неважно. Для SOAP-сервисов имеет смысл параллельно импортировать WSDL: из него подтянутся операции и значения SOAPAction.
Да. Исходные файлы экспорта остаются у вас, коллекцию в Postman импорт не меняет.