Получить список исполнителей с назначенными навыками
Важно
Домен toloka.yandex.com
работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev
для запросов API.
Получает список исполнителей с назначенными навыками. Используя query-параметры, вы можете отфильтровать данные в ответе, например:
-
Получить список всех исполнителей с определенным навыком с помощью query-параметра
skill_id
:GET https://toloka.dev/api/v1/user-skills?skill_id=<skill_id>
-
Получить список всех навыков определенного исполнителя с помощью query-параметра
user_id
:GET https://toloka.dev/api/v1/user-skills?user_id=<user_id>
Запрос
GET https://toloka.dev/api/v1/user-skills
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/user-skills
Authorization: OAuth <OAuth token>
Заголовки
Заголовок | Описание |
---|---|
Authorization | Токен для авторизации аккаунта. В качестве префикса добавьте OAuth. |
Query-параметры
Указываются в ссылке после знака вопроса, перечисляются через &
.
Параметр |
Описание |
user_id |
string Идентификатор исполнителя. Позволяет получить список навыков определенного исполнителя. |
skill_id |
string Идентификатор навыка. Позволяет получить список исполнителей с определенным навыком. |
sort |
string Параметры для сортировки:
О том, как задать сортировку, читайте на странице Сортировка списка объектов. |
Стандартные query-параметры |
|
Пример запроса
Можно настроить показ списка навыков частями (например, по 10 навыков):
- Показать первые 10 навыков, начиная с навыка с наименьшим идентификатором.
- Показывать оставшиеся навыков по 10 штук в порядке возрастания.
Показать первые 10 навыков
GET https://toloka.dev/api/v1/user-skills?sort=id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/user-skills?sort=id&limit=10
Authorization: OAuth <OAuth token>
Показывать остальные части с сортировкой по возрастанию идентификатора
GET https://toloka.dev/api/v1/skills?sort=id&limit=10&id_gt=<ID of the last skill from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/skills?sort=id&limit=10&id_gt=<ID of the last skill from the previous response>
Authorization: OAuth <OAuth token>
Ответ
Свойства навыков исполнителей в массиве items
:
{"items" : [{<user 1 skill 1 >}, {<user 1 skill 2>}, ... {<user 1 skill n>}, ... {<user n skill 1>}, {<user n skill 2>}, ... {<user n skill n>}], "has_more": false}