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

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

Чтение сохранённого срока хранения текущего аккаунта в днях

GET
/api/v1/user/file/retention

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

Поведение

Читает пользовательский срок хранения файлов текущего аккаунта. null означает отсутствие собственной настройки и применение правил платформы. Срок платформы по умолчанию: 30 дней.

Настройка может сократить срок, но не продлить срок платформы. Примеры установки и сброса см. в разделе Установить срок хранения.

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

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

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

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

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

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

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

response = requests.get(
    "https://api.toapis.com/api/v1/user/file/retention",
    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/retention", {
  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.retention_daysinteger | null

Пользовательский срок в днях. При null действуют правила платформы, по умолчанию 30 дней.

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

{
  "code": 0,
  "message": "",
  "data": {
    "retention_days": null
  }
}

Ошибки

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

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