ToAPIsToAPIs
Файлы пользователя

Получить прогресс удаления файлов

Чтение состояния и накопленного прогресса собственного запроса удаления

GET
/api/v1/user/file/deletion-requests/{id}

Для пользователей из материкового Китая: используйте https://api.toapis.cn в качестве эндпоинта (Base URL). Замените https://api.toapis.com на https://api.toapis.cn во всех примерах этого документа.

Поведение

Получает прогресс собственного запроса. Чужие и отсутствующие запросы возвращают 404. Счётчики обновляются асинхронно и сохраняют накопленное число удалений после исчезновения файлов из списка. processed означает завершение текущей обнаруженной области. Поздняя регистрация старых файлов может снова изменить область и состояние; это не подтверждает удаление незарегистрированных объектов.

Аутентификация

Authorizationstringзаголовокобязательно

Используйте системный токен доступа: Bearer YOUR_SYSTEM_ACCESS_TOKEN. Ключи моделей не принимаются, X-User-Id не нужен. Доступны только файлы и настройки текущего аккаунта, без объединения данных субаккаунтов.

Параметры запроса

idstringпутьобязательно

Десятичная строка id из ответа создания запроса, например "456". Это ID запроса удаления, не ID файла.

Без параметров строки запроса и тела. Неизвестные или повторные параметры возвращают 400.

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

curl --request GET \
  --url 'https://api.toapis.com/api/v1/user/file/deletion-requests/456' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'
import requests

response = requests.get(
    "https://api.toapis.com/api/v1/user/file/deletion-requests/456",
    headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
    timeout=30,
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.toapis.com/api/v1/user/file/deletion-requests/456", {
  method: "GET",
  headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
  signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

Поля ответа

Данные примеров вымышлены. Общий формат ответа см. в разделе Подключение.

data.idstring

ID запроса удаления для проверки прогресса.

data.scopestring

single удаляет один файл, all удаляет все существующие файлы текущего аккаунта.

data.file_idstring | null

ID файла для одиночного удаления, иначе null.

data.created_before_atstring | null

Включительная граница времени создания для массового удаления, иначе null.

data.statestring

pending: принят; running: выполняется; processed: текущая область завершена; blocked: заблокированные файлы или ошибка обновления прогресса.

data.discovered_countinteger

Обнаруженное число файлов в области; поздняя регистрация может увеличить его.

data.deleted_countinteger

Накопленное число удалений. Сохраняется после исчезновения файлов из списка.

data.blocked_countinteger

Число заблокированных файлов. Ошибка обновления прогресса тоже может дать blocked с сохранением последних успешных счётчиков.

data.created_atstring

Время создания запроса.

data.updated_atstring

Последнее обновление прогресса.

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

{
  "code": 0,
  "message": "",
  "data": {
    "id": "456",
    "scope": "single",
    "file_id": "123",
    "created_before_at": null,
    "state": "processed",
    "discovered_count": 1,
    "deleted_count": 1,
    "blocked_count": 0,
    "created_at": "2026-11-16T08:00:00Z",
    "updated_at": "2026-11-16T08:02:00Z"
  }
}

Ошибки

Неверный ID или параметры запроса возвращают 400. Отсутствующий или чужой запрос удаления возвращает 404. Временная недоступность чтения прогресса возвращает 503.

Общие правила авторизации, лимитов и ошибок см. в разделе Подключение.