Коллекция Postman в OpenAPI
Postman collection → черновик OpenAPI с примерами и списком невыводимых ограничений.
Можно перетащить файл сюда
JSON
До 1 файла, суммарно 25 МБ. Каждое поле текста — до 1 млн символов.
Для обработки данные передаются нашему серверу. Временные рабочие файлы удаляются; история файлов не создаётся.
Как пользоваться
Черновик paths/operations OpenAPI 3.0; schemas/auth/scripts надо описать вручную.
- Подготовьте JSON Postman v2. Пример показывает: создать черновик OpenAPI paths из Postman collection.
- Запустите обработку и прочитайте диагностику.
- Скачайте JSON OpenAPI. Проверьте paths/methods и вручную заполните схемы ответов и auth.
Пример
Практический пример: Коллекция Postman в OpenAPI
{"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": {…Форматы и ограничения
Папки коллекции обходятся рекурсивно, а URL и method дают paths/operations. Схемы ответов, auth, scripts и тела запросов не выводятся автоматически; предупреждения показывают пропуски и повторные операции. На входе: JSON Postman v2. Форматы результата: JSON OpenAPI.
- На входе
- JSON Postman v2
- Результат
- JSON OpenAPI
Postman v2 collection → черновик OpenAPI paths/operations; схемы тел и auth описываются вручную.
- До 1 файла, суммарно 25 МБ. Каждое поле текста — до 1 млн символов.
- Черновик paths/operations OpenAPI 3.0; schemas/auth/scripts надо описать вручную.
- Для UTF-8-файла текстовый parser допускает до 2 млн символов; поле ввода ограничено 1 млн.
Проверьте paths/methods и вручную заполните схемы ответов и auth.
Для выбранной операции данные передаются нашему серверу. Временные рабочие файлы удаляются после обработки; история пользовательских файлов не создаётся.
Для выбранной операции данные передаются нашему серверу. Временные рабочие файлы удаляются после обработки; история пользовательских файлов не создаётся.
Вопросы об инструменте
Какие исходные данные принимает «Коллекция 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 млн.
Где обрабатываются данные и сохраняется ли история?
Для выбранной операции данные передаются нашему серверу. Временные рабочие файлы удаляются после обработки; история пользовательских файлов не создаётся.