ToAPIsToAPIs
사용자 파일

파일 보존 기간 설정

현재 계정의 파일 보존 기간 설정 또는 해제

PUT
/api/v1/user/file/retention

중국 본토 사용자 안내: 중국 본토 사용자는 https://api.toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://api.toapis.com 을 https://api.toapis.cn 로 바꿔 주세요.

동작

현재 계정의 파일 보존 일수를 설정합니다. 7은 생성부터 7일을 의미합니다. null을 보내 사용자 설정을 해제하고 플랫폼 규칙을 따릅니다.

플랫폼 기본 보존 기간은 30일이며 실제 상한은 현재 플랫폼 설정을 따릅니다. 사용자 값은 상한을 초과할 수 없습니다. 상한이 30일이면 30은 저장되고 31은 400을 반환합니다. 플랫폼 자동 정리가 켜져 있을 때 기존 및 새로 생성한 일반 파일에 적용됩니다.

정리는 비동기입니다. 기한을 줄이면 기존 파일이 다음 정리 대상이 될 수 있습니다. 기한을 늘리거나 해제해도 진행 중 삭제나 이미 제출한 수동 삭제 요청은 취소되지 않습니다.

쿼리 매개변수는 허용하지 않습니다. 본문은 최대 4096바이트의 JSON 객체이며 알 수 없거나 중복된 필드는 거부합니다. 본문 읽기 제한은 10초입니다. 공개 계정 쓰기는 사용자당 분당 10회를 공유합니다. 서비스를 일시적으로 사용할 수 없으면 503입니다.

인증

Authorizationstring헤더필수

시스템 액세스 토큰을 Bearer YOUR_SYSTEM_ACCESS_TOKEN 형식으로 사용합니다. 모델 API Key는 사용할 수 없고 X-User-Id는 필요하지 않습니다. 인증 계정 자신의 파일과 정책만 처리하며 하위 계정 데이터를 합치지 않습니다.

요청 매개변수

retention_daysinteger본문필수

필수 JSON 양의 정수 또는 null. 정수는 현재 플랫폼 상한 이하여야 하며 기본 상한은 30일입니다. 7은 7일, null은 사용자 설정 해제 후 플랫폼 규칙 적용을 뜻합니다. 생략, 0, 음수, 소수, 숫자 문자열은 허용하지 않습니다.

요청 예시

curl --request PUT \
  --url 'https://api.toapis.com/api/v1/user/file/retention' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"retention_days":7}'
import requests

response = requests.put(
    "https://api.toapis.com/api/v1/user/file/retention",
    headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
    json={"retention_days": 7},
    timeout=30,
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.toapis.com/api/v1/user/file/retention", {
  method: "PUT",
  headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({"retention_days": 7}),
  signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

사용자 보존 기한 해제:

curl --request PUT \
  --url 'https://api.toapis.com/api/v1/user/file/retention' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"retention_days":null}'

응답 필드

예제는 가상 데이터입니다. 공통 응답 형식은 시작하기를 참고하세요.

data.retention_daysinteger | null

사용자가 설정한 보존 일수. null이면 플랫폼 규칙을 따르며 기본값은 30일입니다.

응답 예시

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

오류

현재 플랫폼 상한을 초과하면 설정을 저장하지 않고 400 (code=17052)을 반환합니다. 오류 메시지는 Accept-Language에 따라 현지화되며 허용 정수 범위를 안내합니다. data.params.max는 현재 최대 일수입니다.

retention_days 누락 또는 잘못된 값, 잘못된 JSON, 쿼리 매개변수는 400입니다. 서비스를 일시적으로 사용할 수 없으면 503 (code=13035)입니다.

공통 인증, 속도 제한, 오류 처리는 시작하기를 참고하세요.