Получить список ответов

GET /assignments

Получает ответы во всех страницах заданий пула.

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

cURL

Python

Nodejs

curl -X GET 'https://tasks.yandex.ru/api/v1/assignments?pool_id=1085757' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

import requests

url = "https://tasks.yandex.ru/api/v1/assignments"
params = {
  'pool_id': '1085757'
}
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.get(url, params=params, headers=headers)

print(response.text)

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://tasks.yandex.ru/api/v1/assignments',
  'qs': {'pool_id': '1085757'},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

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

Query-параметры

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

Параметр	Описание
`task_id`	string Обязательно указать `task_id`, `pool_id`, либо `task_suite_id`. Идентификатор задания на страницах, сформированных автоматически (с помощью «умного смешивания»). Вы получите ответы для страниц заданий, на которых есть указанное задание.
`task_suite_id`	string Обязательно указать `task_id`, `pool_id`, либо `task_suite_id`. Идентификатор страницы заданий.
`pool_id`	string Обязательно указать `task_id`, `pool_id`, либо `task_suite_id`. Идентификатор пула.
`status`	string Статус выданной страницы заданий. Можно перечислить несколько статусов через запятую: `ACTIVE` — выполняется исполнителем; `SUBMITTED` — выполнена, но не проверена; `ACCEPTED` — принята заказчиком; `REJECTED` — отклонена заказчиком; `SKIPPED` — пропущена исполнителем; `EXPIRED` — истек срок выполнения заданий.
`user_id`	string Идентификатор исполнителя.
`sort`	string Параметры для сортировки: `id` — идентификатор выдачи страницы заданий; `created` — дата выдачи страницы заданий; `submitted` — дата выполнения страницы заданий; `skipped` — дата пропуска страницы заданий; `expired` — дата истечения срока выполнения страницы заданий; `accepted` — дата принятия заказчиком страницы заданий; `rejected` — дата отклонения заказчиком страницы заданий. Примечание Все даты имеют формат ISO 8601: `YYYY-MM-DDThh:mm:ss[.sss]`. О том, как задать сортировку, читайте на странице Сортировка списка объектов.
`limit`	integer Ограничение на количество возвращаемых результатов. По умолчанию — 50, максимум — 100 000.
`id_gt`	string Объекты с идентификатором больше указанного значения.
`id_gte`	string Объекты с идентификатором больше или равным указанному значению.
`id_lt`	string Объекты с идентификатором меньше указанного значения.
`id_lte`	string Объекты с идентификатором меньше или равным указанному значению.
`created_gt`	string Объекты, выданные или созданные после указанной даты.
`created_gte`	string Объекты, выданные или созданные после указанной даты включительно.
`created_lt`	string Объекты, выданные или созданные до указанной даты.
`created_lte`	string Объекты, выданные или созданные до указанной даты включительно.
`submitted_gt`	string Объекты, выданные или созданные после указанной даты.
`submitted_gte`	string Объекты, выданные или созданные после указанной даты включительно.
`submitted_lt`	string Объекты, выданные или созданные до указанной даты.
`submitted_lte`	string Объекты, выданные или созданные до указанной даты включительно.
`accepted_gt`	string Объекты, принятые заказчиком после указанной даты.
`accepted_gte`	string Объекты, принятые заказчиком после указанной даты включительно.
`accepted_lt`	string Объекты, принятые заказчиком до указанной даты.
`accepted_lte`	string Объекты, принятые заказчиком до указанной даты включительно.
`rejected_gt`	string Объекты, отклоненные заказчиком после указанной даты.
`rejected_gte`	string Объекты, отклоненные заказчиком после указанной даты включительно.
`rejected_lt`	string Объекты, отклоненные заказчиком до указанной даты.
`rejected_lte`	string Объекты, отклоненные заказчиком до указанной даты включительно.
`skipped_gt`	string Объекты, пропущенные после указанной даты.
`skipped_gte`	string Объекты, пропущенные после указанной даты включительно.
`skipped_lt`	string Объекты, пропущенные до указанной даты.
`skipped_lte`	string Объекты, пропущенные до указанной даты включительно.
`expired_gt`	string Объекты, у которых срок выполнения истекает после указанной даты.
`expired_gte`	string Объекты, у которых срок выполнения истекает после указанной даты включительно.
`expired_lt`	string Объекты, у которых срок выполнения истекает до указанной даты.
`expired_lte`	string Объекты, у которых срок выполнения истекает до указанной даты включительно.

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

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

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

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

cURL

curl -X GET 'https://tasks.yandex.ru/api/v1/assignments?pool_id=1085757&sort=id&limit=10' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

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

cURL

curl -X GET 'https://tasks.yandex.ru/api/v1/assignments?pool_id=1085757&sort=id&limit=10&id_gt={ID_страницы_заданий_из_предыдущего_ответа}' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Ответ

Содержит свойства ответов в массиве items:

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

Пример ответа

{
  "items": [
    {
      "id": "00022cfa46--637cf4098ccdeb4a260737de",
      "task_suite_id": "00022cfa46--637cf4098ccdeb4a260737dc",
      "pool_id": "36502086",
      "user_id": "d26d7d094e0dbb67ec46a269dc5dd15c",
      "status": "ACCEPTED",
      "reward": 1,
      "tasks": [
        {
          "id": "00022cfa46--637cf3fb6e13181a0164e7e6",
          "input_values": {
            "image": "https://example.com/image1.jpg"
          },
          "pool_id": "36502086",
          "overlap": 3,
          "infinite_overlap": false,
          "reserved_for": [],
          "unavailable_for": [],
          "created": "2022-11-22T16:08:27.575",
          "remaining_overlap": 0
        }
      ],
      "solutions": [
        {
          "output_values": {
            "result": "cat"
          }
        }
      ],
      "mixed": true,
      "automerged": false,
      "created": "2022-11-22T16:08:41.802",
      "submitted": "2022-11-22T16:09:08.603",
      "accepted": "2022-11-22T16:09:08.603",
      "owner": {
        "id": "6c6e20dc86cca2ae787afcb2629de162",
        "myself": true
      }
    }
  ],
  "has_more": true
}

Параметр

Описание

items

array of objects

Массив со списком ответов исполнителей и их свойств.

has_more

boolean

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

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

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

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

См. подробнее о фильтрации запросов.
false — в ответе содержатся все имеющиеся элементы.

Была ли статья полезна?

Получение ответов

Получить свойства ответа