Українська
Контрольна точка
Що має працювати
powershell
dotnet buildpowershell
dotnet test --solution Chatex.slnxpowershell
./Run.ps1 apiЗакомітьте:
powershell
git add .powershell
git commit -m "Expose the business layer as a Minimal API with JWT authentication and OpenAPI"Типові помилки
Таблиця 12.1. Типові помилки в HTTP API
| Симптом | Причина | Виправлення |
|---|---|---|
кожен запит відповідає 401, навіть із токеном | MapInboundClaims дорівнює true, тож sub перетворився на довгий URI й GetUserId нічого не знаходить – або видавець, одержувач чи ключ відрізняються від сервісу токенів | MapInboundClaims = false; налаштуйте параметри Bearer з JwtOptions |
перелічення надходять як числа ("type": 1) | бракує JsonStringEnumConverter | додайте його в ConfigureHttpJsonOptions |
помилки – порожні відповіді 401/404 без тіла | бракує AddProblemDetails або UseStatusCodePages | додайте обидва |
/scalar відповідає 404 | API працює в іншому середовищі | запустіть із профілем http (./Run.ps1 api) |
OptionsValidationException про Storage або Jwt під час запуску | в appsettings.Development.json немає розділів | порівняйте з лістингом |
| cookie оновлення ніколи не повертається в тестах | тестовий клієнт використовує http://localhost | використайте https://localhost як базову адресу |
WebApplicationFactory<Program> не компілюється | Program не видно | додайте public partial class Program; наприкінці Program.cs |
Питання для самоперевірки
- Як ASP.NET Core дізнається, звідки береться кожен параметр кінцевої точки Minimal API?
- Що містить відповідь Problem Details? Що додає Chatex і навіщо?
- Що дає тип, що повертається,
Results<Ok<T>, ProblemHttpResult>, порівняно зIResult? - Чому токен оновлення лежить у cookie, а токен доступу – ні? Поясніть кожен із чотирьох атрибутів cookie.
- Чому всі кінцеві точки під
/apiзахищено за замовчуванням? - Що змінюють у перевірці токена
MapInboundClaims = false,ValidAlgorithmsіClockSkew? - У якому порядку має виконуватися проміжне програмне забезпечення і чому автентифікація має йти перед авторизацією?
- Чому OpenAPI і Scalar увімкнено лише в Development?
- Що запускає
WebApplicationFactoryі що він замінює? - Чому тести API звертаються до
https://localhost?
Вправи
- Кінцева точка версії. Зіставте
GET /api/version(анонімну), що повертає{ "version": "…" }з версії збірки. Додайте тест. - Новий фільтр. Додайте необов’язковий параметр запиту
?type=groupдоGET /api/chats, що фільтрує сторінку за типом чату. Які рівні змінюються? Де краще це зробити: у кінцевій точці, сервісі чи репозиторії? - Прочитайте документ OpenAPI. Відкрийте
http://localhost:5214/openapi/v1.jsonі знайдіть операціюCreateChat: які відповіді оголошено і звідки API про них дізналося?