Зачем нужен конвертер
Когда вы получаете OpenAPI-спецификацию от внешнего API или вашего бэкенд-разработчика, нужно быстро запустить тест-запросы. Ручная настройка коллекции в Postman для 20–50 эндпоинтов — это 1–2 часа. Автоматическая конвертация — 5 секунд.
Importing OpenAPI specifications is a fast way to bootstrap a Postman collection with all endpoints pre-configured.— Postman Documentation
Форматы вывода
- Postman Collection v2.1 — стандартный формат Postman. Импорт через File → Import. Path-параметры становятся переменными коллекции.
- cURL команды — готовые однострочники с заголовками, query, body. Можно копировать в bash, или сохранить как .sh-скрипт.
Ограничения
Конвертер реализован в браузере (JavaScript) — он не использует тяжёлый openapi-generator. Поэтому:
- Сложные allOf / oneOf / anyOf — упрощённо.
- Discriminator (полиморфизм) — не разрешается, генерируется первая схема.
- $ref на внешние файлы — не поддерживается, только локальные components/schemas.
- Только JSON-формат spec (YAML — сначала через YAML → JSON конвертер).
Для сложных API с десятками вложенных схем используйте openapi-generator — это CLI с Java или Node. Наш инструмент — для типичных REST-API с прямой структурой.
- OpenAPI Specification 3.1. OpenAPI Initiative (Linux Foundation). spec.openapis.org/oas/v3.1.0. 2024.
- Postman Collection Format v2.1. Postman Inc.. schema.getpostman.com/json/collection/v2.1.0. обновляется.
- cURL Manual. Daniel Stenberg. curl.se/docs/manual.html. обновляется.
