APIСтандартизация и документация
Тема 1 · 4 курс

Маршрут темы

122 слайда · от HTTP-запроса к стандарту, который проверяет CI

План преподавателя

Источники и материалы

Ссылки и версии сверены 15 и 16 сентября 2026 года.

RFC 9110 · HTTP Semantics ↗ RFC 9457 · Problem Details for HTTP APIs ↗ RFC 2119 · MUST, SHOULD, MAY ↗ OpenAPI Specification 3.2.0 · 19 сентября 2025 ↗ OpenAPI Specification, последняя редакция · 3.2.1 от 10 сентября 2026 ↗ Roy Fielding · Representational State Transfer, глава 5 диссертации ↗ Swagger Docs · What Is OpenAPI? ↗ FastAPI · Metadata and Docs URLs ↗ GitHub Docs · API Versions ↗ GitHub Docs · Breaking changes ↗ Semantic Versioning 2.0.0 ↗ Keep a Changelog 1.1.0 ↗ stoplightio/spectral ↗ OWASP API Security Top 10 2023 ↗ Zalando RESTful API Guidelines ↗ Microsoft API Guidelines ↗ adidas API Guidelines ↗ github/rest-api-description ↗ Redocly/openapi-starter ↗ digitalocean/openapi ↗ box/box-openapi ↗ OAI/OpenAPI-Specification ↗

Кадры сняты 15 сентября 2026 года: официальные страницы и открытые репозитории — в браузере без входа в аккаунт, Swagger UI, ReDoc и /openapi.json — на запущенном учебном проекте. Оранжевые рамки добавлены при съёмке и отмечают, куда смотреть.

Источники всех правил: цитаты, переводы, варианты компанийСписок кадров: что снято и откудаПлан преподавателя и уточнения сценарияРепозиторий учебного проекта на GitHub ↗Опубликованная документация API ↗

Кадр крупным планом