API – Список користувачів
- Для отримання списку користувачів потрібно надіслати GET запит на URI/api/v2/users/list.
- Запит повинен містити заголовки Content-Type: application/json;charset=UTF-8 та X-Cbr-Authorization: Bearer API_TOKEN.
Приклад запиту:
curl 'https://your-domain.davintoo.com/api/v2/users/list' -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: application/json;charset=UTF-8'
Запит підтримує фільтрацію по наступним полям:
- (ПІБ або емейл або логін)fullname
- Посадаposition
- Підрозділdepartment
- Містоcity
- Мітки користувачаtags
Приклад запиту з пошуком по емейлу:
curl 'https://your-domain.davintoo.com/api/v2/users/list?filter[fullname][email protected] -H 'X-Cbr-Authorization: Bearer API_TOKEN' -H 'Content-Type: application/json;charset=UTF-8'
Відповідь
-
В разі успішного запиту (HTTP код відповіді - 200), буде повернено результат у форматі JSON виду:
- масив результатівdata
- об'єкт пагінації (інформація про кількість сторінок, поточну сторінку, к-сті результатів)"pager":{"current":1,"count":16,"total":155,"countPerPage":10}
-
В разі помилки (HTTP код відповіді - 400) повертає JSON об'єкт з інформацією про помилку