Получить список навыков исполнителя

  1. Запрос
  2. Заголовки
  3. Query-параметры
  4. Пример запроса
  5. Ответ

Получает список навыков исполнителя.

Запрос

GET https://toloka.yandex.com/api/v1/user-skills
Authorization: OAuth <OAuth token>

Заголовки

Заголовок Описание
Authorization Токен для авторизации аккаунта. В качестве префикса добавьте OAuth.
Заголовок Описание
Authorization Токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Query-параметры

Указываются в ссылке после знака вопроса, перечисляются через &.

Параметр Описание
user_id

string

Идентификатор исполнителя.

skill_id

string

Идентификатор навыка.

sort

string

Параметры для сортировки:

  • id — идентификатора навыка;

  • created — дата создания навыка по UTC в формате YYYY-MM-DD;

  • modified — дата изменения навыка по UTC в формате YYYY-MM-DD.

О том, как задать сортировку, читайте на странице Сортировка списка объектов.

Стандартные query-параметры limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, modified_gt, modified_gte, modified_lt, modified_lte
Параметр Описание
user_id

string

Идентификатор исполнителя.

skill_id

string

Идентификатор навыка.

sort

string

Параметры для сортировки:

  • id — идентификатора навыка;

  • created — дата создания навыка по UTC в формате YYYY-MM-DD;

  • modified — дата изменения навыка по UTC в формате YYYY-MM-DD.

О том, как задать сортировку, читайте на странице Сортировка списка объектов.

Стандартные query-параметры limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, modified_gt, modified_gte, modified_lt, modified_lte

Пример запроса

Можно настроить показ списка навыков частями (например, по 10 навыков):
  1. Показать первые 10 навыков, начиная с навыка с наименьшим идентификатором.
  2. Показывать оставшиеся навыков по 10 штук в порядке возрастания.
Показать первые 10 навыков
GET https://toloka.yandex.com/api/v1/user-skills?sort=id&limit=10
Authorization: OAuth <OAuth token>
Показывать остальные части с сортировкой по возрастанию идентификатора
GET https://toloka.yandex.com/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 skill 1>}, {<user skill 2>}, ... {<user skill n>}], "has_more": false}