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

Получить список операций

Важно

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

Получает список созданных операций.

Запрос

GET https://toloka.dev/api/v1/operations
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/operations
Authorization: OAuth <OAuth token>

Заголовки

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

Query-параметры

Указываются в ссылке после знака вопроса, перечисляются через &.

Параметр

Описание

type

string

Тип операции:

  • POOL.OPEN — открытие пула;
  • POOL.CLOSE — закрытие пула;
  • PROJECT.ARCHIVE — отправка проекта в архив;
  • POOL.ARCHIVE — отправка пула в архив;
  • TASK_SUITE.BATCH_CREATE — создание нескольких страниц заданий;
  • KNOWN_SOLUTIONS.GENERATE — генерация контрольных заданий.

status

string

Статус операции:

  • PENDING — выполнение не началось;
  • RUNNING — выполняется;
  • SUCCESS — успешно выполнена;
  • FAIL — не выполнена.

sort

string

Параметры для сортировки:

  • id — идентификатор операции;
  • submitted — дата и время отправки запроса по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss];
  • finished — дата и время завершения операции по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

О том, как задать сортировку, читайте на странице Сортировка списка объектов.

Стандартные query-параметры

  • limit (integer — ограничение на количество возвращаемых результатов. По умолчанию — 50, максимум — 300)
  • id_gt (string — объекты с идентификатором больше указанного значения)
  • id_gte (string — объекты с идентификатором больше или равным указанному значению)
  • id_lt (string — объекты с идентификатором меньше указанного значения)
  • id_lte (string — объекты с идентификатором меньше или равным указанному значению)
  • submitted_gt (string — объекты, выданные или созданные после указанной даты)
  • submitted_gte (string — объекты, выданные или созданные после указанной даты включительно)
  • submitted_lt (string — объекты, выданные или созданные до указанной даты)
  • submitted_lte (string — объекты, выданные или созданные до указанной даты включительно)
  • finished_gt (string — объекты, завершенные после указанной даты)
  • finished_gte (string — объекты, завершенные после указанной даты включительно)
  • finished_lt (string — объекты, завершенные до указанной даты)
  • finished_lte (string — объекты, завершенные до указанной даты включительно)

Ответ

Содержит список операций в массиве items:

{"items": [{operation details 1}, {operation details 2}, ... {operation details n}], "has_more": false}