Aggregate responses in a pool

To start the response aggregation for all completed tasks in the pool, send a POST request to the /api/v1/aggregated-solutions/aggregate-by-pool.

Request

POST /api/v1/aggregated-solutions/aggregate-by-pool

Host: https://sandbox.toloka.yandex.ru
Authorization: OAuth <OAuth token>
{
  "pool_id": "283",
  "type": "WEIGHTED_DYNAMIC_OVERLAP", 
  "answer_weight_skill_id": "1289",
  "fields": [
    {
      "name": "result"
    }
  ]
}
Key descriptions

Key

Value

Data type

pool_id Pool ID. String
type Aggregation type. WEIGHTED_DYNAMIC_OVERLAP — Aggregation of responses in a pool with dynamic overlap. String
answer_weight_skill_id A skill that determines the weight of the performer's response. String
fields Output data fields to use for aggregating responses. For best results, each of these fields must have a limited number of response options. JSON
fields.name The output data field name. String

Response

Contains operation details: Check the operation status. When it is completed get the aggregation results.

{
  "id": "fadfe3jk-fdafue2-fda32890-fdafdi23",
  "type": "SOLUTION.AGGREGATE",
  "status": "PEDNDING",
  "submitted": "2018-22-10T14:18:35",
  "progress" : 0,
  "parameters": {
    "pool_id": "283"
  }
}
Key descriptions

Key

Value

Data type

id

Operation ID.

String

type

Operation type:

  • POOL.OPEN — Opening a pool.

  • POOL.CLOSE — Closing a pool.

  • PROJECT.ARCHIVE — Archiving a project.

  • POOL.ARCHIVE — Archiving a pool.

  • SOLUTION.AGGREGATE — Aggregation of responses.
  • TASK_SUITE.BATCH_CREATE — Creating multiple task suites.

String

status

The status of the operation:

  • PENDING — Not started yet.

  • RUNNING — In progress.

  • SUCCESS — Completed successfully.

  • FAIL — Not completed.

String

submitted

The UTC date and time the request was sent, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

String

progress

The percentage of the operation completed.

Number

parameters

Operation parameters (depending on the operation type).

JSON