Получить срок хранения файлов
Чтение сохранённого срока хранения текущего аккаунта в днях
Для пользователей из материкового Китая: используйте 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.
Общие правила авторизации, лимитов и ошибок см. в разделе Подключение.