Агрегировать ответы в пуле

POST /aggregated-solutions/aggregate-by-pool

Запускает агрегацию ответов на все выполненные задания в пуле.

Ограничение

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

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

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

curl -X POST 'https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-pool' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"pool_id":"1238218", "type":"WEIGHTED_DYNAMIC_OVERLAP", "answer_weight_skill_id":"12648", "fields":[{"name":"result"}]}'
import requests

url = "https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-pool"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "pool_id": "1238218",
  "type": "WEIGHTED_DYNAMIC_OVERLAP",
  "answer_weight_skill_id": "12648",
  "fields": [
    {
      "name": "result"
    }
  ]
}
response = requests.post(url, headers=headers, json=payload)

print(response.text)
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-pool',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "pool_id": "1238218",
    "type": "WEIGHTED_DYNAMIC_OVERLAP",
    "answer_weight_skill_id": "12648",
    "fields": [
      {
        "name": "result"
      }
    ]
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

Заголовок

Описание

Authorization

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

Content-Type

Указывает формат данных (application/json) в передаваемом теле запроса.

Тело и параметры запроса

{
  "type": "DAWID_SKENE",
  "pool_id": 1491600,
  "fields": [
    {
      "name": "result"
    }
  ]
}
{
  "type": "WEIGHTED_DYNAMIC_OVERLAP",
  "pool_id": "1238218",
  "fields": [
    {
      "name": "result"
    }
  ],
  "answer_weight_skill_id": "12648"
}

Параметр

Описание

type*

string

Способ агрегации результатов:

  • WEIGHTED_DYNAMIC_OVERLAP — агрегация ответов в пуле на основе навыка исполнителя.
  • DAWID_SKENE — агрегация ответов в пуле без динамического перекрытия. Ключ answer_weight_skill_id для этого типа агрегации игнорируется.

pool_id*

string

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

fields*

object

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

Если выбран тип агрегации DAWID_SKENE, то можно указать только одно значение.

fields.name*

string

Имя поля выходных данных.

answer_weight_skill_id

string (обязательный при условии)

Обязателен, если выбран тип агрегации WEIGHTED_DYNAMIC_OVERLAP.

Навык, который определяет вес ответа исполнителя.

Ответ

Содержит сведения об операции. Проверяйте статус операции. После ее завершения получите результаты агрегации.

Примеры ответа
{
  "id": "5530b051-f9b1-445c-b54c-ac56f9b09ada",
  "type": "SOLUTION.AGGREGATE",
  "status": "RUNNING",
  "submitted": "2023-04-13T16:39:12.422",
  "started": "2023-04-13T16:39:12.478",
  "progress": 0,
  "parameters": {
    "pool_id": "1491600",
    "algorithm": "DAWID_SKENE",
    "pool_name": "Image classification",
    "project_id": "133047",
    "input_fields": [
      "image"
    ],
    "requester_id": "6c6e20dc86cca2ae787afcb2629de162",
    "missing_output_fields": [],
    "aggregated_output_fields": [
      "result"
    ]
  },
  "details": {}
}
{
  "id": "430fa011-6053-4664-b0b7-0c4e50ea91ed",
  "type": "SOLUTION.AGGREGATE",
  "status": "PENDING",
  "submitted": "2023-04-13T16:37:58.126",
  "progress": 0,
  "parameters": {
    "pool_id": "1491600",
    "algorithm": "WEIGHTED_DYNAMIC_OVERLAP",
    "pool_name": "Image classification",
    "project_id": "133047",
    "requester_id": "6c6e20dc86cca2ae787afcb2629de162",
    "aggregated_fields": [
      {
        "name": "result"
      }
    ],
    "answer_weight_skill_id": 12648
  }
}```

Параметр

Описание

id

string

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

type

string

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

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

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

object

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

details

object

Детали выполнения операции. См. подробнее в разделе Детали выполнения операции.

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