18 подписчиков
Swagger и OpenAPI — это не одно и то же, хотя их часто путают даже опытные разработчики.
OpenAPI — открытый стандарт описания REST API, который в 2015 году передали Linux Foundation. Swagger — набор инструментов компании SmartBear для работы с этим стандартом: редактор, визуализатор, генератор кода. Путаница живёт потому, что до переименования сам стандарт тоже назывался Swagger.
В статье разбираем: чем отличаются Swagger Editor, Swagger UI и Swagger Codegen, почему OpenAPI подходит не для всех архитектур и как выбрать между AsyncAPI, GraphQL, RAML и API Blueprint — в зависимости от задачи.
Около минуты
17 июля