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