Создать навык
Важно
Домен toloka.yandex.com
работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev
для запросов API.
Создает навык.
Ограничение
Можно отправить не более 10 таких запросов в минуту и не более 100 в день.
Запрос
POST https://toloka.dev/api/v1/skills
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
POST https://sandbox.toloka.dev/api/v1/skills
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
Заголовки
Заголовок | Описание |
---|---|
Authorization | Токен для авторизации аккаунта. В качестве префикса добавьте OAuth. |
Content-Type | Указывает формат данных в передаваемом теле запроса. |
Тело запроса
{
"name": "Determining the color of an elephant",
"private_comment": "Skill for my pool",
"hidden": true,
"skill_ttl_hours": 240
}
Параметр |
Описание |
name |
string | обязательный Название навыка. |
private_comment |
string Комментарий к навыку (доступен только заказчику). |
hidden |
boolean Доступ к сведениям о навыке (название и значение) для исполнителей:
По умолчанию значение |
skill_ttl_hours |
integer Время жизни навыка после последнего обновления (в часах). Навык будет удален у исполнителя, если его значение не обновлялось в течение указанного срока. |
Ответ
Свойства и идентификатор навыка.
{
"id": "9238",
"name": "Determining the color of an elephant",
"private_comment": "Skill for my pool",
"hidden": true,
"skill_ttl_hours": 240,
"deprecated": false,
"owner": {
"id": "c3a50f44cd3e1b8202465569ced289eb",
"myself": true
},
"created": "2021-12-01T08:37:03.387",
"global": false
}
Параметр |
Описание |
id |
string Идентификатор навыка. |
name |
string Название навыка. |
private_comment |
string Комментарий к навыку (доступен только заказчику). |
hidden |
boolean Доступ к сведениям о навыке (название и значение) для исполнителей:
По умолчанию значение |
skill_ttl_hours |
integer Время жизни навыка после последнего обновления (в часах). Навык будет удален у исполнителя, если его значение не обновлялось в течение указанного срока. |
deprecated |
boolean Прекращение поддержки навыка его создателем:
|
owner |
object Параметры заказчика, который создал проект. |
owner.id |
string Идентификатор заказчика. |
owner.myself |
boolean Проверяет, кому принадлежит объект:
|
training |
boolean Связь навыка с обучающим пулом:
|
created |
string Дата и время создания навыка по UTC в формате ISO 8601: |
global |
boolean Признак глобального навыка:
|