Проверка заданий

PATCH /assignments/{id}

Проверить задания вручную и отклонить их, если задание выполнено неудовлетворительно. Чтобы принять или отклонить полученные ответы, измените статус страницы заданий с помощью PATCH-запроса к ресурсу /assignments/{ID_выдачи_страницы_заданий}:

Принять ответы: измените статус SUBMITTED на ACCEPTED.
Отклонить ответы: измените статус SUBMITTED на REJECTED.
Изменить решение об отклонении: измените статус REJECTED на ACCEPTED.

Чтобы отклоненные задания отправлялись на повторное выполнение другим исполнителям, добавьте в пул блок контроля качества (см. Повторное выполнение заданий).

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

cURL

Python

Nodejs

curl -X PATCH 'https://tasks.yandex.ru/api/v1/assignments/0001d38f5b--61c8be211c3a7842a596ac0a' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"status":"ACCEPTED", "public_comment":"OK"}'

import requests

url = "https://tasks.yandex.ru/api/v1/assignments/0001d38f5b--61c8be211c3a7842a596ac0a"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "status": "ACCEPTED",
  "public_comment": "OK"
}
response = requests.patch(url, headers=headers, json=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'PATCH',
  'url': 'https://tasks.yandex.ru/api/v1/assignments/0001d38f5b--61c8be211c3a7842a596ac0a',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "status": "ACCEPTED",
    "public_comment": "OK"
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

id*

string

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

Заголовки

Заголовок	Описание
`Authorization`	API-токен для авторизации аккаунта. В качестве префикса добавьте `OAuth`.
`Content-Type`	Указывает формат данных (`application/json`) в передаваемом теле запроса.

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

{
  "status": "ACCEPTED",
  "public_comment": "Well done!"
}

Параметр

Описание

status

string

Статус выданной страницы заданий. Можно перечислить несколько статусов через запятую:

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

public_comment

string

Комментарий исполнителю. Максимальная длина: 2048 символов.

Ответ

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

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

{
  "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 Значения выходных данных для предварительных ответов исполнителей.

Узнайте больше

Проверка ответов исполнителей

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

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

Файлы в ответах