APIСтандартизация
тема 1
Открыть слайдами →

Часть 15 из 15 · слайды 121–122

Итог темы

Практическая работа закрывает тему. Соберём весь процесс в одну схему.

  1. 121Как теперь выглядит процесс разработки API
  2. 122От описания API — к проверке его качества

121Как теперь выглядит процесс разработки API

Стандартизация сопровождает API на протяжении всего жизненного цикла.

  1. BUSINESS DOMAIN
  2. RESOURCES
  3. API STYLE GUIDE
  4. HTTP CONTRACT
  5. OPENAPI
  6. FASTAPI IMPLEMENTATION
  7. SWAGGER UI / REDOC
  1. LINTER
  2. CONTRACT TESTS
  3. GITHUB
  4. CI
  5. API RELEASE
  6. CHANGELOG / VERSIONING / DEPRECATION

Левая колонка продолжается в правой: после документации изменение проходит линтер и тесты.

122От описания API — к проверке его качества

После этого блока логично переходить к отдельной теме: автоматизированный API Governance.

Там можно глубже разобрать:

  • Spectral custom rules;
  • OpenAPI linting;
  • contract testing;
  • schema compatibility;
  • breaking-change detection;
  • GitHub Actions quality gates;
  • security checks.
Сейчас
«мы договорились
 писать API одинаково»
Дальше
«repository технически
 не позволит нарушить
 часть этих правил»
  1. DOCUMENTED STANDARD
  2. ENFORCED STANDARD

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