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

Отправить пул в архив

Важно

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

Переносит пул в архив.

Если пул не используется, его можно перенести в архив. Пул должен быть в статусе «закрыт».

Пул с отклоненными заданиями можно заархивировать через 9 дней с момента последнего отклонения. Этот период необходим для того, чтобы пересмотреть результаты, если исполнитель подал апелляцию.

Экзамены с автоматической приемкой по точности, в которых отклоняются задания с недостаточной точностью, тоже можно заархивировать через 9 дней.

Запрос

POST https://toloka.dev/api/v1/pools/<pool_id>/archive
Authorization: OAuth <OAuth token>
POST https://sandbox.toloka.dev/api/v1/pools/<pool_id>/archive
Authorization: OAuth <OAuth token>

Path-параметры

Параметр Описание
pool_id Идентификатор пула.

Заголовки

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

Ответ

Примечание

Если пул уже архивирован, при попытке повторно отправить его в архив будет возвращен пустой ответ со статусом 204.

Содержит сведения о выполнении операции.

{
  "id" : "57068577e4b0bf7b07a0256f",
  "type" : "POOL.ARCHIVE",
  "status" : "SUCCESS",
  "submitted" : "2016-04-07T16:06:15.902",
  "started" : "2016-04-07T16:06:15.902",
  "finished" : "2016-04-07T16:06:15.902",
  "progress" : 100,
  "parameters" : {
    "pool_id" : "1"
  }
}

Параметр

Описание

id

string

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

type

string

Тип операции: POOL.ARCHIVE — отправка пула в архив.

status

string

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

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

submitted

string

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

started

string

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

finished

string

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

progress

integer

Ход выполнения операции в процентах.

parameters.pool_id

string

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