Использую
REST/OpenAPI
Спецификация и проектирование API
О инструменте и моём опыте
OpenAPI (ранее Swagger) — стандарт описания REST API, который использую как основу API-first подхода. Проектирую спецификации до написания кода, генерирую клиенты и серверы.
Как использую в работе
- API-first проектирование: спецификация → код
- OpenAPI 3.1 с JSON Schema
- Генерация Go-клиентов (oapi-codegen)
- Документирование API через Swagger UI / Redoc
- Версионирование и breaking changes management
Сценарии применения
- Проектирование API микросервисов
- Генерация клиентов и серверов
- Документирование API для команд