Українська
Тема 12. HTTP API на Minimal API: групи кінцевих точок, Problem Details, автентифікація JWT, корінь композиції та OpenAPI
Мета: відкрити бізнес-рівень через HTTP: перетворити результати на коди стану й Problem Details за RFC 9457 зі стабільними кодами, зіставити кінцеві точки автентифікації, профілів, користувачів, чатів і повідомлень, захистити їх токенами JWT Bearer і cookie оновлення, скомпонувати застосунок у Program.cs, описати його через OpenAPI та Scalar і протестувати через справжній конвеєр HTTP.
Де ми зараз
Модуль 4 будує веб-рівень (рис. 12.1). Після цієї теми Chatex стане API, яке можна викликати з браузера, зі Scalar, з файлів .http і з тестів.
Рис. 12.1. Веб-рівень над бізнес-рівнем
- Відправна точка: тема 11 – бізнес-рівень завершено; проходить 60 тестів. Chatex.Api досі лишається «Hello World» із теми 2.
- Наприкінці теми API працює на
http://localhost:5214з інтерактивним довідником за адресою/scalar, а новий тестовий проєктChatex.Api.Testsперевіряє 16 сценаріїв через HTTP.
Кроки
- Від результатів до HTTP – Minimal API · коди стану та Problem Details · користувач, що викликає API · контракти запитів і відповідей
- Кінцеві точки автентифікації – cookie з токеном оновлення · реєстрація, вхід, оновлення, вихід
- Групи кінцевих точок – профілі, користувачі, чати й повідомлення · параметри маршруту · типізовані результати
- Корінь композиції – пакети й налаштування ·
AddApi· JWT Bearer · конвеєр проміжного програмного забезпечення · OpenAPI і Scalar · запуск API - Тестування через HTTP –
WebApplicationFactory· клієнт для кожного користувача · перевірки HTTP-відповідей · тести кінцевих точок - Контрольна точка – що має працювати, питання для самоперевірки та вправи
Матеріали
- Презентація курсу (англійською), частина 3, «Серверна частина на C#» (слайди «The composition root: Program.cs», «From Result to HTTP», «Authentication with rotating tokens»)
Program.cs,DependencyInjection.cs,Endpoints/,Infrastructure/Docs/HttpApi.md– маршрути, токени, посторінкове читання, обмеження та коди помилок- Тема курсу C#: REST API