OpenAPI.Tools
Оставайтесь в курсе созданного сообществом списка современных и высококачественных инструментов для OpenAPI.
Есть ли инструмент, который, по вашему мнению, должен быть в этом списке? Отправьте Pull Request на GitHub по адресу https://github.com/apisyouwonthate/openapi.tools
Вот краткий обзор типов инструментов, организованных по категориям, чтобы вы могли перейти к интересующему вас разделу:
-
Auto Generators (Автогенераторы): Инструменты, которые берут ваш код и превращают его в документ OpenAPI Specification.
-
Converters (Конвертеры): Различные инструменты для конвертации в и из форматов описания API, включая OpenAPI.
-
Data Validators (Проверщики данных): Проверяют, соответствуют ли запросы и ответы API описанию API.
-
Description Validators (Проверщики описания): Проверяют ваше описание API на соответствие стандарту OpenAPI.
-
Documentation (Документация): Преобразуют описание API в HTML (или, возможно, PDF), чтобы менее технически подкованные люди могли разобраться в работе с API.
-
DSL (Язык описания предметной области): Писать YAML вручную не всегда удовольствие, и, возможно, вы не хотите использовать графический интерфейс. Так что используйте DSL для написания OpenAPI на выбранном вами языке.
-
Gateways (Шлюзы): Шлюзы API и связанные инструменты, которые имеют встроенную поддержку OpenAPI.
-
GUI Editors (Графические редакторы): Визуальные редакторы помогают вам проектировать API без необходимости запоминать всю спецификацию OpenAPI.
-
Learning (Обучение): Независимо от того, пытаетесь ли вы получить документацию для API сторонних разработчиков на основе трафика или же пытаетесь перейти к разработке с учетом дизайна в организации, где OpenAPI отсутствует, обучение может помочь вам двигать вашу спецификацию API вперед и поддерживать ее в актуальном состоянии.
-
Miscellaneous (Прочее): Любые другие инструменты, работающие с OpenAPI, но не имеющие достаточно функциональности для собственной категории.
-
Mock Servers (Мок-серверы): Фиктивные серверы, которые используют документ описания как входные данные, затем маршрутизируют входящие HTTP-запросы к примерным ответам или динамически генерируют примеры.
-
Monitoring (Мониторинг): Инструменты мониторинга. Отслеживание работоспособности.
-
Parsers (Парсеры): Загружают и считывают описания OpenAPI, чтобы вы могли работать с ними программно.
-
SDK Generators (Генераторы SDK): Генерируют код, который можно передать потребителям, чтобы помочь им избежать взаимодействия на уровне HTTP.
-
Security (Безопасность): Путем изучения вашего описания OpenAPI некоторые инструменты могут обнаруживать потенциальные векторы атак, которые вы могли бы упустить из виду.
-
Server Implementations (Реализации сервера): Легко создавайте и реализуйте ресурсы и маршруты для ваших API.
-
Testing (Тестирование): Быстро выполняйте запросы к API и проверяйте ответы на лету через командную строку или графический интерфейс.
-
Text Editors (Текстовые редакторы): Текстовые редакторы предоставляют визуальную обратную связь при написании OpenAPI, так что вы можете видеть, как могли бы выглядеть документация.
Если у вас есть какие-либо конкретные вопросы или интересует определенная категория инструментов, пожалуйста, дайте знать, и я с удовольствием предоставлю дополнительную информацию.
Автогенераторы
Инструменты, которые преобразуют ваш код в документацию по спецификации OpenAPI.
Имя | Язык | v3.1 | v3.0 | v2.0 | GitHub |
---|---|---|---|---|---|
GranthAi - Генератор документации на основе OpenAPI 3 для NodeJs, который находится между серверными API и всеми, кто вызывает эти API | Javascript | ❌ | ✅ | ❌ | npm |
har-to-openapi - Автоматическая генерация спецификации OpenAPI 3.0 с использованием сетевых запросов, захваченных в одном или нескольких файлах HAR | TypeScript | ❌ | ✅ | ❌ | |
har2openapi - Автоматическая генерация спецификации OpenAPI 3.0 с использованием сетевых запросов, захваченных в одном или нескольких файлах HAR | TypeScript | ❌ | ✅ | ❌ |
Эти инструменты могут быть полезными для автоматизации процесса создания документации API, особенно если у вас уже есть код, который вы хотите документировать.
Шлюзы API
API-шлюзы и связанные с ними инструменты, которые имеют интегрированную поддержку OpenAPI.
Имя | Язык | v3.1 | v3.0 | v2.0 | GitHub |
---|---|---|---|---|---|
Fusio - Открытая платформа управления API | PHP | ❌ | ✅ | ❌ | |
Kong Enterprise Edition - Высоконастраиваемый портал для разработчиков с интеграцией в Kong API Gateway | Lua | ✅ | ✅ | ✅ | |
KrakenD API Gateway - KrakenD — высокопроизводительный, безсостоянийный API-шлюз, интегрированный с OpenAPI | Golang | ❌ | ✅ | ✅ | |
Kusk Gateway - Kusk-Gateway — это API-шлюз для Kubernetes, управляемый через OpenAPI | Kubernetes | ❌ | ✅ | ✅ | |
Traefik Hub - Traefik Hub — решение для управления API на платформе Kubernetes | Go | ❌ | ✅ | ✅ | |
wiretap - Wiretap — инструмент для тестирования соответствия OpenAPI | Go | ✅ | ✅ | ✅ | |
Zuplo (OpenAPI-based gateway and documentation) - Zuplo — API-шлюз, разработанный для разработчиков и работающий на базе OpenAPI | Web / SaaS | ✅ | ✅ | ❌ |
Эти инструменты предоставляют различные функции для управления и документирования API, и многие из них интегрированы с OpenAPI. Они могут быть полезными для разработчиков, которые хотят упростить и автоматизировать процесс работы с API.
Мониторинг
Инструменты мониторинга позволяют вам понимать, что происходит с вашим API.
Название | Язык | v3.1 | v3.0 | v2.0 | GitHub |
---|---|---|---|---|---|
Treblle — это легковесный SDK, который помогает инженерным и продуктовым командам быстрее создавать, отправлять и поддерживать REST-основанные API. | ✅ | ✅ | ❌ |
Примечания
- ✅ означает поддержку данной версии OpenAPI.
- ❌ означает отсутствие поддержки данной версии OpenAPI.