Выбор исходных данных и способа обработки
Черновик paths/operations OpenAPI 3.0; schemas/auth/scripts надо описать вручную.
- На входе: JSON Postman v2.
- Результат: JSON OpenAPI.
Порядок действий
Создать черновик OpenAPI paths из Postman collection
- Подготовьте JSON Postman v2. Пример показывает: создать черновик OpenAPI paths из Postman collection.
- Запустите обработку и прочитайте диагностику.
- Скачайте JSON OpenAPI. Проверьте paths/methods и вручную заполните схемы ответов и auth.
Практический пример
Фрагмент результата: { "openapi": "3.0.3", "info": { "title": "Catalog", "version": "0.1.0" }, "paths": { "/items": { "get": { "summary": "Products", "responses": { "200": {…
{"info":{"name":"Catalog","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"item":[{"name":"Products","request":{"method":"GET","url":"https://example.com/items"}}]}Фрагмент результата: {
"openapi": "3.0.3",
"info": {
"title": "Catalog",
"version": "0.1.0"
},
"paths": {
"/items": {
"get": {
"summary": "Products",
"responses": {
"200": {…Проверьте paths/methods и вручную заполните схемы ответов и auth.
Ограничения и проверка готового файла
Проверьте paths/methods и вручную заполните схемы ответов и auth.
Для выбранной операции данные передаются нашему серверу. Временные рабочие файлы удаляются после обработки; история пользовательских файлов не создаётся.
Официальные требования: Postman Collection 2.1 schema · OpenAPI specification 3.1.1
- До 1 файла, суммарно 25 МБ. Каждое поле текста — до 1 млн символов.
- Черновик paths/operations OpenAPI 3.0; schemas/auth/scripts надо описать вручную.
- Для UTF-8-файла текстовый parser допускает до 2 млн символов; поле ввода ограничено 1 млн.
Вопросы и ответы
Какие исходные данные принимает «Коллекция Postman в OpenAPI»?
Поддерживаются: JSON Postman v2. До 1 файла, суммарно 25 МБ. Каждое поле текста — до 1 млн символов.
Что получится после обработки в «Коллекция Postman в OpenAPI»?
Postman v2 collection → черновик OpenAPI paths/operations; схемы тел и auth описываются вручную. Форматы результата: JSON OpenAPI.
Как проверить результат этой операции?
Проверьте paths/methods и вручную заполните схемы ответов и auth.
Какой пример помогает начать работу?
{"info":{"name":"Catalog","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"item":[{"name":"Products","request":{"method":"GET","url":"https://example.com/items"}}]}. Создать черновик OpenAPI paths из Postman collection Ожидаемый результат: Фрагмент результата: { "openapi": "3.0.3", "info": { "title": "Catalog", "version": "0.1.0" }, "paths": { "/items": { "get": { "summary": "Products", "responses": { "200": {….
Какие ограничения нужно учитывать?
До 1 файла, суммарно 25 МБ. Каждое поле текста — до 1 млн символов. Черновик paths/operations OpenAPI 3.0; schemas/auth/scripts надо описать вручную. Для UTF-8-файла текстовый parser допускает до 2 млн символов; поле ввода ограничено 1 млн.
Где обрабатываются данные и сохраняется ли история?
Для выбранной операции данные передаются нашему серверу. Временные рабочие файлы удаляются после обработки; история пользовательских файлов не создаётся.