diff --git a/polygon-docs/sonnet-swagger-review-prompt.md b/polygon-docs/sonnet-swagger-review-prompt.md index a65b34c..372c248 100644 --- a/polygon-docs/sonnet-swagger-review-prompt.md +++ b/polygon-docs/sonnet-swagger-review-prompt.md @@ -54,6 +54,33 @@ - Не усложнять — полигон это мок, не прод - Не предлагать автогенерацию из кода через декораторы +## Дополнительные вопросы + +### requestInterceptor и X-Mock-Auth + +Сейчас `swagger.html` добавляет только `Authorization: Bearer` через `requestInterceptor`. +Но `_mock/*` эндпоинты проверяют заголовок `X-Mock-Auth`, а не `Authorization`. +Как правильно дописать `requestInterceptor` чтобы оба механизма работали: +- `Authorization: Bearer ` — для всех эндпоинтов (если включена глобальная auth) +- `X-Mock-Auth: ` — только для `_mock/*` + +### docExpansion + +Какое значение `docExpansion` оптимально для Swagger UI 5? +- `"list"` — раскрыты только названия тегов (средний вариант) +- `"none"` — всё свёрнуто (минимализм) +- `"full"` — все эндпоинты раскрыты (но может быть перегружено) + +Учитывая что есть 5 тегов (services, instances, operations, health, mock) и ~17 эндпоинтов. + +### Примеры ответов (examples) + +В каких схемах стоит добавить `example` чтобы Try it out был максимально полезен? +Например: +- `Instance` с реальными данными (instanceUid, serviceId, status, state.params, state.out) +- `CfsParam` с valueList (чтобы было видно как выглядят enum-параметры) +- `Operation` до run (dtStart=null, dtFinish=null) и после run (всё заполнено) + ## Формат ответа Сгруппируй находки так: