Создать навык

POST /skills

Создает навык.

Ограничение

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

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

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

cURL

Python

Nodejs

curl -X POST 'https://tasks.yandex.ru/api/v1/skills' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"name":"Programmer","public_name":{"EN":"Programmer"},"public_requester_description":{"EN":"You are an expert in programming languages"}}'

import requests

url = "https://tasks.yandex.ru/api/v1/skills"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "name": "Programmer",
  "public_name": {
    "EN": "Programmer"
  },
  "public_requester_description": {
    "EN": "You are an expert in programming languages"
  }
}
response = requests.post(url, headers=headers, json=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://tasks.yandex.ru/api/v1/skills',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "name": "Programmer",
    "public_name": {
      "EN": "Programmer"
    },
    "public_requester_description": {
      "EN": "You are an expert in programming languages"
    }
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

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

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

{
  "name": "Programmer",
  "public_name": {
    "EN": "Programmer"
  },
  "public_requester_description": {
    "EN": "You are an expert in programming languages"
  },
  "private_comment": "Got at least 5 right responses on control tasks with C++ or Python",
  "hidden": true,
  "deprecated": false
}

Параметр	Описание
`name`*	string Название навыка.
`public_name`	object Имя навыка, которые увидят исполнители.
`public_requester_description`	object Описание навыка, которые увидят исполнители.
`private_comment`	string Комментарий к навыку (доступен только заказчику).
`hidden`	boolean Доступ к сведениям о навыке (название и значение) для исполнителей: `true` — закрыт; `false` — открыт. По умолчанию значение `true`.
`skill_ttl_hours`	integer Время жизни навыка после последнего обновления (в часах). Навык будет удален у исполнителя, если его значение не обновлялось в течение указанного срока.
`deprecated`	boolean Прекращение поддержки навыка его создателем: `true` — поддержка прекращена, навык требует замены; `false` — поддержка ведется, навык актуальный.

Ответ

Свойства и идентификатор навыка.

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

{
  "id": "37825",
  "name": "product search relevance",
  "public_name": {
    "EN": "product search relevance"
  },
  "private_comment": "",
  "hidden": true,
  "deprecated": false,
  "owner": {
    "id": "6c6e20dc86cca2ae787afcb2629de162",
    "myself": true
  },
  "created": "2022-01-25T09:19:16.455",
  "global": false
}

Параметр	Описание
`id`	string Идентификатор навыка.
`name`	string Название навыка.
`public_name`	object Имя навыка, которые видят исполнители.
`public_requester_description`	object Описание навыка, которые видят исполнители.
`private_comment`	string Комментарий к навыку (доступен только заказчику).
`hidden`	boolean Доступ к сведениям о навыке (название и значение) для исполнителей: `true` — закрыт; `false` — открыт. По умолчанию значение `true`.
`skill_ttl_hours`	integer Время жизни навыка после последнего обновления (в часах). Навык будет удален у исполнителя, если его значение не обновлялось в течение указанного срока.
`deprecated`	boolean Прекращение поддержки навыка его создателем: `true` — поддержка прекращена, навык требует замены; `false` — поддержка ведется, навык актуальный.
`owner`	object Параметры заказчика, который создал навык.
`owner.id`	string Идентификатор заказчика.
`owner.myself`	boolean Проверяет, кому принадлежит объект: `true` — заказчику, чей OAuth-токен указан в запросе; `false` — другому аккаунту (сотруднику или владельцу).
`training`	boolean Связь навыка с обучающим пулом: `true` — навык подсчитывается по заданиям обучающего пула; `false` — навык не связан с обучающим пулом.
`created`	string Дата и время создания навыка по UTC в формате ISO 8601: `YYYY-MM-DDThh:mm:ss[.sss]`.
`global`	boolean Признак глобального навыка: `true` — навык глобальный, показывает общие компетенции исполнителей, доступен всем исполнителям; `false` — навык создан заказчиком, может быть назначен исполнителям как вручную, так и автоматически: с помощью правил контроля качества или после прохождения обучения.

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

Создание навыка

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

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

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