docs: document stock screener

2026-10-11 11:18:40 +03:00
parent f0cab445d7
commit 2c34023af8
6 changed files with 52 additions and 21 deletions
@@ -21,6 +21,17 @@ artifact у себя и проверяет соответствие generated ty
 API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
 environment policy, а не используется frontend в runtime.

+## Скринер акций
+
+`POST /api/v1/stocks/screener/search` всегда создаёт новый результат по
+условиям скринера, включая пустой подтверждённый список. Ответ первой страницы
+содержит непрозрачный `searchId`, время получения каталога и признак следующей
+страницы. `GET /api/v1/stocks/screener/search/{searchId}?page=...` читает
+последующую страницу того же результата, не запускает новый поиск и сохраняет
+состав и время списка. Идентификатор результата принадлежит текущему пользователю
+и его подключению; недоступный или чужой результат возвращает ошибку, а не
+пустой список. Точные поля и статусы определяет backend-generated OpenAPI.
+
 ## Инвестиционные данные и синхронизация

 Затронутые GET инвестиционных ресурсов возвращают сгенерированный contract