Документация Толоки

Получить сведения о блокировке

Важно

Домен toloka.yandex.com работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev для запросов API.

Получает сведения о блокировке.

Запрос

GET https://toloka.dev/api/v1/user-restrictions/<ban_id>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/user-restrictions/<ban_id>
Authorization: OAuth <OAuth token>

Path-параметры

Параметр Описание
ban_id Идентификатор блокировки.

Заголовки

Заголовок Описание
Authorization Токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Ответ

Содержит параметры блокировки в формате JSON. Пример:

{
  "scope": "PROJECT",
  "user_id": "f25a5f41-94e8-49bf-977f-3611087a16b3",
  "project_id": "10",
  "private_comment": "Many mistakes",
  "will_expire": "2016-04-10T18:08:07",
  "id": "54",
  "created": "2016-03-28T18:08:07"
}

Параметр

Описание

scope

string

Область блокировки:

  • ALL_PROJECTS — все проекты заказчика;
  • PROJECT — проект (указывается project_id);
  • POOL — пул (указывается pool_id).

user_id

string

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

project_id

string

Указывается, если scope=PROJECT.

Идентификатор проекта, к которому заблокирован доступ.

pool_id

string

Указывается, если scope=POOL.

Идентификатор пула, к которому заблокирован доступ.

private_comment

string

Комментарий с причиной ограничения доступа.

Максимальная длина: 499 символов.

will_expire

string

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

created

string

Дата и время по UTC блокировки в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

id

string

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