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

GET /skills/{id}

Получает свойства навыка, ID которого указан в запросе.

Можно получить идентификатор ({id}) из списка навыков.

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

curl -X GET 'https://tasks.yandex.ru/api/v1/skills/11051' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'
import requests

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

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

Path-параметры

Параметр

Описание

id*

string

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

Заголовки

Заголовок

Описание

Authorization

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

Ответ

Сведения о навыке.

Пример ответа
{
  "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 — навык создан заказчиком, может быть назначен исполнителям как вручную, так и автоматически: с помощью правил контроля качества или после прохождения обучения.

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