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

PUT /user-skills

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

Ограничение

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

См. полный список ограничений на странице Ограничение количества запросов.

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

cURL

Python

Nodejs

curl -X PUT 'https://tasks.yandex.ru/api/v1/user-skills' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"skill_id":"11051","user_id":"1ad097faba0eff85a04fe30bc04d53db","value":50}'

import requests

url = "https://tasks.yandex.ru/api/v1/user-skills"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "skill_id": "11051",
  "user_id": "1ad097faba0eff85a04fe30bc04d53db",
  "value": 50
}
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',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "skill_id": "11051",
    "user_id": "1ad097faba0eff85a04fe30bc04d53db",
    "value": 50
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

Заголовок	Описание
`Authorization`	API-токен для авторизации аккаунта. В качестве префикса добавьте `OAuth`.
`Content-Type`	Указывает формат данных (`application/json`) в передаваемом теле запроса.

Тело и параметры запроса

{
  "skill_id": 11051,
  "user_id": "1ad097faba0eff85a04fe30bc04d53db",
  "value": 50,
  "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`	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]`.

Узнайте больше

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

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

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