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

PUT /user-skills/batch

Задает значение одного или нескольких навыков.

Ограничение

Вы можете отправить не более 1000 навыков в одном запросе.

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

curl -X PUT 'https://tasks.yandex.ru/api/v1/user-skills/batch?skip_invalid_items=true' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '[
           {
             "skill_id": "32",
             "user_id": "566ec2b0ff0deeaae5f9d500",
             "value": 59.7,
             "reason": "High-quality performance of tasks"
           },
           {
             "skill_id": "33",
             "user_id": "566ec2b0ff0deeaae5f9d500",
             "value": 75.0,
             "reason": "High-quality performance of tasks"
           }
         ]'

import requests

url = "https://tasks.yandex.ru/api/v1/user-skills/batch?skip_invalid_items=true"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = [
  {
    "skill_id": "32",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 59.7,
    "reason": "High-quality performance of tasks"
  },
  {
    "skill_id": "33",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 75.0,
    "reason": "High-quality performance of tasks"
  }
]
response = requests.put(url, headers=headers, json=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'PUT',
  'url': 'https://tasks.yandex.ru/api/v1/user-skills/batch',
  'qs': {'skip_invalid_items': 'true'},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify([
    {
      "skill_id": "32",
      "user_id": "566ec2b0ff0deeaae5f9d500",
      "value": 59.7,
      "reason": "High-quality performance of tasks"
    },
    {
      "skill_id": "33",
      "user_id": "566ec2b0ff0deeaae5f9d500",
      "value": 75.0,
      "reason": "High-quality performance of tasks"
    }
  ])
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Query-параметры

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

skip_invalid_items

boolean

Параметры валидации JSON-объектов:

  • true — назначить навык, если JSON-объект со сведениями о навыке прошел валидацию. В противном случае пропустить назначение навыка.
  • false — остановить операцию и не назначать навыки, если хотя бы один JSON-объект не прошел валидацию.

Значение по умолчанию — false.

operation_id

string

Идентификатор операции.

Заголовки

Заголовок

Описание

Authorization

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

Content-Type

Указывает формат данных (application/json) в передаваемом теле запроса.

Тело запроса

{
  "skill_id": "32",
  "user_id": "566ec2b0ff0deeaae5f9d500",
  "value": 59.7,
  "reason": "High-quality performance of tasks"
}

[
  {
    "skill_id": "32",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 59.7,
    "reason": "High-quality performance of tasks"
  },
  {
    "skill_id": "33",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 75.0,
    "reason": "High-quality performance of tasks"
  }
]

Параметр

Описание

skill_id*

string

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

user_id*

string

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

value*

float

Дробное значение навыка. Минимум — 0, максимум — 100.

reason

string

Причина изменения или назначения навыка.

Ответ

Обновленное значение навыка.

Пример ответа
{
  "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"
}

Массив с обновленными значениями навыков.

Пример ответа
[
  {
    "id": "1813606616",
    "skill_id": "32",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 59.7,
    "exact_value": 60,
    "created": "2025-01-25T09:21:58.854",
    "modified": "2025-01-25T09:21:58.854"
  },
  {
    "id": "1813606617",
    "skill_id": "33",
    "user_id": "566ec2b0ff0deeaae5f9d500",
    "value": 75.0,
    "exact_value": 75,
    "created": "2025-01-25T09:21:58.854",
    "modified": "2025-01-25T09:21:58.854"
  }
]

Параметр

Описание

id

string

Идентификатор навыка исполнителя, присваивается паре «навык-исполнитель»

skill_id

string

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

user_id

string

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

value

integer

Целое значение навыка (exact_value, округленное до ближайшего целого). Минимум — 0, максимум — 100.

exact_value

float

Дробное значение навыка. Минимум — 0, максимум — 100.

created

string

Дата и время по UTC, когда исполнителю был впервые присвоен навык с заданным значением. Формат даты ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

modified

string

Дата и время по UTC, когда изменился уровень навыка у исполнителя. Формат даты ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

Обязательный параметр

Предыдущая
Задать значение навыка
Следующая
Задать значения навыков асинхронно