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

POST /api/v1/assignments

Получает свойства одного или нескольких ответов.

Ограничение

Вы можете отправить не более 100 идентификаторов ответов в одном запросе.

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

curl -X POST 'https://tasks.yandex.ru/api/v1/assignments' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '["response_id1", "response_id2"]'
import requests

url = "https://tasks.yandex.ru/api/v1/assignments"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = ["response_id1", "response_id2"]
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/assignments',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify(["response_id1", "response_id2"])
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

Заголовок

Описание

Authorization

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

Content-Type

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

Тело запроса

В теле запроса укажите список идентификаторов ответов.

Пример тела запроса
["response_id1", "response_id2"]

Ответ

Содержит свойства ответов, указанных в теле запроса.

Пример ответа
[
  {
    "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
    }
  }
]

Параметр

Описание

id

string

Идентификатор выдачи страницы заданий исполнителю.

task_suite_id

string

Идентификатор страницы заданий.

pool_id

string

Идентификатор пула, в который входит страница заданий.

user_id

string

Идентификатор исполнителя, который получил страницу заданий.

status

string

Статус выданной страницы заданий:

  • ACTIVE — выполняется исполнителем;
  • SUBMITTED — выполнена, но не проверена;
  • ACCEPTED — принята заказчиком;
  • REJECTED — отклонена заказчиком;
  • SKIPPED — пропущена исполнителем;
  • EXPIRED — истек срок выполнения заданий.

reward

integer

Плата, которую получил исполнитель.

public_comment

string

Комментарий исполнителю.

Максимальная длина: 2048 символов.

bonus_ids[]

array of strings

ID бонусов, выплаченных за задание.

tasks[]

array of objects

Данные заданий.

first_declined_solution_attempt[]

array of objects

Для обучающих заданий. Первоначальные ответы исполнителя в обучающем задании (только если эти ответы были неправильными). Если исполнитель ответил правильно с первой попытки, массив first_declined_solution_attempt отсутствует.

Массивы с ответами (output_values) расположены в том же порядке, что и данные заданий в массиве tasks.

{
  "output_values": {
    "<field 1>": <response>,
    "<field 2>": <response>
     ...
    "<field N>": <response>
  },
  ...
}

Полный список параметров приведен в таблице Ответы исполнителя.

solutions[]

array of objects

Ответы исполнителя. Расположены в том же порядке, что и данные заданий в массиве tasks.

{
  "output_values": {
    "<field 1>": <response>,
    "<field 2>": <response>
    ...
    "<field N>": <response>
  },
  ...
}

Полный список параметров приведен в таблице Ответы исполнителя.

mixed

boolean

Способ создания страницы заданий:

  • true — автоматически («умное смешивание»);
  • false — вручную.

По умолчанию false.

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

automerged

boolean

Флаг ответа, полученного в результате слияния идентичных заданий. Значение:

  • true — ответ записан в результате слияния идентичных заданий;
  • false — обычный ответ исполнителя.

created

string

Дата и время, когда страница заданий была выдана исполнителю. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

submitted

string

Дата и время, когда страница заданий была выполнена исполнителем. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

accepted

string

Дата и время, когда ответы к странице заданий были приняты заказчиком. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

rejected

string

Дата и время, когда ответы к странице заданий были отклонены заказчиком. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

skipped

string

Дата и время, когда страница заданий была пропущена исполнителем. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

expired

string

Дата и время, когда время на выполнение страницы заданий истекло. Приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

owner.id

string

Идентификатор заказчика.

owner.myself

boolean

Проверяет, кому принадлежит объект:

  • true — исполнителю, чей OAuth-токен указан в запросе;
  • false — другому аккаунту (сотруднику или владельцу).

owner. company_id

string

Идентификатор компании заказчика.

Ответы исполнителя ('first_declined_solution_attempt' и 'solutions')

Параметр

Описание

id

string

Идентификатор ответа исполнителя.

task_id

string

Идентификатор задания.

assignment_id

string

Идентификатор выданного задания.

output_values

object

Значения выходных данных для предварительных ответов исполнителей.