WSDL в OpenAPI: REST-фасад для SOAP-сервиса
Как получить черновик спецификации OpenAPI из WSDL: операции становятся методами POST, сообщения — схемами запросов и ответов, ошибки — ответом 500.
Пошаговые инструкции: как конвертировать, проверять, рисовать и вести документацию в Помощнике SA.
Как получить черновик спецификации OpenAPI из WSDL: операции становятся методами POST, сообщения — схемами запросов и ответов, ошибки — ответом 500.
Как писать спецификацию OpenAPI в браузере: YAML или JSON слева, документация Swagger UI справа, переход по $ref, скачивание и хранение версий.
Как перевести спецификацию Swagger 2.0 на OpenAPI 3.0: серверы, тела запросов, формы, ответы и схемы безопасности переносятся автоматически.
Что проверяется в редакторе OpenAPI: синтаксис YAML и JSON, повторяющиеся ключи, ссылки $ref, отрисовка в Swagger UI — и как получить ревью дизайна API.
Как разбить большую спецификацию OpenAPI на файлы — общие схемы, параметры, ответы — и работать с ней как с одной: ссылки по папкам проекта, переход Ctrl+кликом.
Как получить диаграмму классов по схемам спецификации OpenAPI: поля с типами и кратностью, связи между схемами, наследование и перечисления.
Как получить из OpenAPI один файл JSON Schema со всеми схемами — для проверки данных, генерации и тестов: nullable, example и ссылки переводятся автоматически.
Как получить коллекцию Postman из OpenAPI или Swagger: папки по тегам, параметры и тела запросов с примерами, авторизация и переменные baseUrl и token.
Как получить готовые команды curl для каждой операции OpenAPI: адрес и токен в переменных окружения, параметры, заголовки и тела запросов из примеров.
Как получить схемы данных для API из модели DBML: таблицы — объекты, типы SQL — типы JSON, перечисления, обязательность и внешние ключи в описаниях.