GET /user docs

README.md

@@ -140,15 +140,28 @@ Kafka worker нужен для того, чтобы разгребать пос
 
 - Обновить информацию о другом пользователе из конкретноой категории можно только при наличии права на изменение в этой категории (см. `category.update_scope`)
 
-### Получить информацию о пользователе
+### Получить информацию о пользователе/пользователях
 
-Дернуть ручку `GET /user/{user_id}`. Информация вернутся в соотвествии с переданными scopes.
+#### Получить информацию о пользователе по id
+
+Дернуть ручку `GET /user/{user_id}`.
 
 - Пользователь может получить всю информацию о себе
 
-- Любой другой человек может получить только информацию из тех категорий на которые у него есть права (см `category.read_scope`)
+#### Получить информацию о нескольких пользователях об указанных категориях
+
+Дернуть ручку `GET /user?users=...?categories=...`. 
+
+- Ручка закрыта за скоупом `userdata.info.admin`
+
+- Query параметры `users` и `categories` обязательные
+
+В обеих `GET /user/` ручках информация будет возвращаться таким образом:
+
+- В соответствии с переданными scopes
+- Можно получить только информацию из тех категорий на которые у него есть права (см `category.read_scope`)
+- С поставленными `param.type`.
 
-- Информация будет возвращаться в соответствии с поставленными `param.type`.
   - Если поставлен `all` то вернется информация соотв. данному параметру из всех источников
   - `last` - вернется последняя обновленная информация
   - `most_trusted` - вернется информация из самого доверенного источника