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

Получить агрегированные ответы

Важно

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

Получает агрегированные ответы.

Запрос

GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/aggregated-solutions/<operation_id>
Authorization: OAuth <OAuth token>

Path-параметры

Параметр Описание
operation_id Идентификатор операции.

Заголовки

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

Query-параметры

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

Параметр

Описание

sort

string

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

  • task_id — идентификатор задания.

Чтобы изменить направление сортировки (сортировать по убыванию), добавьте знак дефиса перед параметром: sort=-task_id.

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

  • limit (integer — ограничение на количество возвращаемых результатов. По умолчанию — 50, максимум — 300)
  • task_id_gt (string — задания с идентификатором больше указанного значения)
  • task_id_gte (string — задания с идентификатором, больше или равным указанному значению)
  • task_id_lt (string — задания с идентификатором меньше указанного значения)
  • task_id_lte (string — задания с идентификатором, меньше или равным указанному значению)

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

Можно настроить показ списка ответов частями (например, по 10 ответов):

  1. Показать первые 10 ответов, начиная с ответа с наименьшим идентификатором задания.
  2. Показывать оставшиеся ответы по 10 штук в порядке возрастания.

Показать первые 10 ответов

GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10
Authorization: OAuth <OAuth token>

Показывать остальные части с сортировкой по возрастанию идентификатора

GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10&task_id_gt=<ID of the last task from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10&task_id_gt=<ID of the last task from the previous response>
Authorization: OAuth <OAuth token>

Ответ

Результат агрегации в массиве items.

{"items" : [{task #1}, {task #2}, ... {task #n}], "has_more": true}