Получить список страниц заданий
Важно
Домен toloka.yandex.com
работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev
для запросов API.
Получает список страниц заданий в пуле.
Запрос
GET https://toloka.dev/api/v1/task-suites
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/task-suites
Authorization: OAuth <OAuth token>
Заголовки
Заголовок | Описание |
---|---|
Authorization | Токен для авторизации аккаунта. В качестве префикса добавьте OAuth. |
Query-параметры
Указываются в ссылке после знака вопроса, перечисляются через &
.
Параметр |
Описание |
pool_id |
string Идентификатор пула, из которого нужно получить страницы заданий. Обязательно указать |
task_id |
string Идентификатор задания на страницах, сформированных автоматически (с помощью «умного смешивания»). Вы получите страницы заданий, на которых есть указанное задание. Обязательно указать |
sort |
string Параметры для сортировки:
О том, как задать сортировку, читайте на странице Сортировка списка объектов. |
overlap |
integer Страницы с перекрытием, равным указанному значению. |
Стандартные query-параметры |
|
Пример запроса
Можно настроить показ перечня страниц заданий частями (например, по 10 страниц):
- Показать первые 10 страниц заданий, начиная со страницы с наименьшим идентификатором.
- Показывать оставшиеся страницы заданий по 10 штук в порядке возрастания.
Показать первые 10 страниц заданий
GET https://toloka.dev/api/v1/task-suites?sort=id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/task-suites?sort=id&limit=10
Authorization: OAuth <OAuth token>
Показывать остальные части с сортировкой по возрастанию идентификатора
GET https://toloka.dev/api/v1/task-suites?sort=id&limit=10&id_gt=<id of the last task suite from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/task-suites?sort=id&limit=10&id_gt=<id of the last task suite from the previous response>
Authorization: OAuth <OAuth token>
Ответ
Содержит страницы заданий в массиве items
:
{"items" : [{task suite 1}, {task suite 2}, ... {task suite n}], "has_more": true}