Как работает OpenAPI в Python?

OpenAPI (ex-Swagger) — спецификация для описания REST API. JSON/YAML формат: paths, schemas, parameters, responses. FastAPI генерирует OpenAPI автоматически из type hints и Pydantic моделей. /docs — Swagger UI, /redoc — ReDoc. Можно кастомизировать: tags, description, examples, deprecated. openapi_extra — дополнительные поля. Генерация клиентов: openapi-generator — клиент на любом языке из спецификации. Flask: flask-smorest, connexion. Django: drf-spectacular. OpenAPI 3.1 — совместим с JSON Schema. Документация из кода — всегда актуальна.