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

GET /aggregated-solutions/{operation_id}

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

Ограничение

Вы можете отправить не более 5 таких запросов в минуту, не более 30 в час и не более 200 в день.

См. полный список ограничений на странице Ограничение количества запросов.

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

curl -X GET 'https://tasks.yandex.ru/api/v1/aggregated-solutions/5c04458e-63c1-46c1-ba0d-6f0756a5358b' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'
import requests

url = "https://tasks.yandex.ru/api/v1/aggregated-solutions/5c04458e-63c1-46c1-ba0d-6f0756a5358b"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.get(url, headers=headers)

print(response.text)
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://tasks.yandex.ru/api/v1/aggregated-solutions/5c04458e-63c1-46c1-ba0d-6f0756a5358b',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

operation_id*

string

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

Заголовки

Заголовок

Описание

Authorization

API-токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Query-параметры

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

Параметр

Описание

sort

string

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

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

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

limit

integer

Ограничение на количество возвращаемых результатов. По умолчанию — 50, максимум — 100 000.

task_id_gt

string

Задания с идентификатором больше указанного значения.

task_id_gte

string

Задания с идентификатором, больше или равным указанному значению.

task_id_lt

string

Задания с идентификатором меньше указанного значения.

task_id_lte

string

Задания с идентификатором, меньше или равным указанному значению.

Больше примеров

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

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

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

curl -X GET 'https://tasks.yandex.ru/api/v1/aggregated-solutions/5c04458e-63c1-46c1-ba0d-6f0756a5358b?sort=task_id&limit=10' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

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

curl -X GET 'https://tasks.yandex.ru/api/v1/aggregated-solutions/5c04458e-63c1-46c1-ba0d-6f0756a5358b?sort=task_id&limit=10&task_id_gt={ID_последнего_задания_из_предыдущего_ответа}' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Ответ

Список результатов агрегации и их свойств в массиве items.

{
  "items": [
    {task #1},
    {task #2},
    ...
    {task #n}
  ],
  "has_more": true
}
Пример ответа
{
  "items": [
    {
      "confidence": 1,
      "pool_id": "36502086",
      "task_id": "00022cfa46--637cf3fb6e13181a0164e7e6",
      "output_values": {
        "result": "cat"
      }
    }
  ],
  "has_more": true
}

Параметр

Описание

items

array of objects

Массив со списком результатов агрегаций и их свойств.

has_more

boolean

Показывает, является ли список элементов в ответе полным.

Возможные значения:

  • true — не все элементы вошли в ответ из-за ограничений в параметре limit.

    Можно получить остальные результаты с помощью параметров с постфиксами _lt(e) и _gt(e).

    См. подробнее о фильтрации запросов.

  • false — в ответе содержатся все имеющиеся элементы.

Обязательный параметр