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

GET /user-skills

Получает список исполнителей с назначенными навыками. Используя query-параметры, вы можете отфильтровать данные в ответе, например:

Получить список всех исполнителей с определенным навыком с помощью query-параметра skill_id:
```
GET https://tasks.yandex.ru/api/v1/user-skills?skill_id={skill_id}
```
Получить список всех навыков определенного исполнителя с помощью query-параметра user_id:
```
GET https://tasks.yandex.ru/api/v1/user-skills?user_id={user_id}
```

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

cURL

Python

Nodejs

curl -X GET 'https://tasks.yandex.ru/api/v1/user-skills?user_id=fac97860c7929add8048ed2ef63b66fd' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

import requests

url = "https://tasks.yandex.ru/api/v1/user-skills"
params = {
  'user_id': 'fac97860c7929add8048ed2ef63b66fd'
}
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.get(url, params=params, headers=headers)

print(response.text)

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://tasks.yandex.ru/api/v1/user-skills',
  'qs': {'user_id': 'fac97860c7929add8048ed2ef63b66fd'},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

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

Query-параметры

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

Параметр	Описание
`user_id`	string Идентификатор исполнителя. Позволяет получить список навыков определенного исполнителя.
`skill_id`	string Идентификатор навыка. Позволяет получить список исполнителей с определенным навыком.
`sort`	string Параметры для сортировки: `id` — идентификатора навыка; `created` — дата создания навыка по UTC в формате ISO 8601: `YYYY-MM-DDThh:mm:ss[.sss]`; `modified` — дата изменения навыка по UTC в формате ISO 8601: `YYYY-MM-DDThh:mm:ss[.sss]`. О том, как задать сортировку, читайте на странице Сортировка списка объектов.
`limit`	integer Ограничение на количество возвращаемых результатов. По умолчанию — 20, максимум — 1000.
`id_gt`	string Объекты с идентификатором больше указанного значения.
`id_gte`	string Объекты с идентификатором больше или равным указанному значению.
`id_lt`	string Объекты с идентификатором меньше указанного значения.
`id_lte`	string Объекты с идентификатором меньше или равным указанному значению.
`created_gt`	string Объекты, выданные или созданные после указанной даты.
`created_gte`	string Объекты, выданные или созданные после указанной даты включительно.
`created_lt`	string Объекты, выданные или созданные до указанной даты.
`created_lte`	string Объекты, выданные или созданные до указанной даты включительно.
`modified_gt`	string Объекты, измененные после указанной даты.
`modified_gte`	string Объекты, измененные после указанной даты включительно.
`modified_lt`	string Объекты, измененные до указанной даты.
`modified_lte`	string Объекты, измененные до указанной даты включительно.

Больше примеров

Можно настроить показ списка навыков частями (например, по 10 навыков):

Показать первые 10 навыков, начиная с навыка с наименьшим идентификатором.
Показывать оставшиеся навыков по 10 штук в порядке возрастания.

Показать первые 10 навыков

cURL

curl -X GET 'https://tasks.yandex.ru/api/v1/user-skills?sort=id&limit=10' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Показать остальные части с сортировкой по возрастанию идентификатора

cURL

curl -X GET 'https://tasks.yandex.ru/api/v1/user-skills?sort=id&limit=10&id_gt={ID_последнего_навыка_из_предыдущего_ответа}' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Ответ

Свойства навыков исполнителей в массиве 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
}

Пример ответа

{
  "items": [
    {
      "id": "1813606616",
      "skill_id": "37825",
      "user_id": "23c3835c9bbe4ec5418f7ef28c7ff5fb",
      "value": 100,
      "exact_value": 100,
      "created": "2022-01-25T09:21:58.854",
      "modified": "2022-01-25T09:21:58.854"
    }
  ],
  "has_more": true
}

Параметр

Описание

items

array of objects

Массив со списком навыков исполнителей и их свойств.

has_more

boolean

Показывает, является ли список элементов в ответе полным.

Возможные значения:

true — не все элементы вошли в ответ из-за ограничений в параметре limit.

Можно получить остальные результаты с помощью параметров с постфиксами _lt(e) и _gt(e).

См. подробнее о фильтрации запросов.
false — в ответе содержатся все имеющиеся элементы.

Была ли статья полезна?

Редактировать навык

Задать значение навыка