파일 삭제 진행 상황 조회
본인 삭제 요청의 상태와 누적 진행 상황 조회
중국 본토 사용자 안내: 중국 본토 사용자는 https://api.toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://api.toapis.com 을 https://api.toapis.cn 로 바꿔 주세요.
동작
현재 계정의 삭제 요청 진행 상황을 조회합니다. 다른 계정의 요청과 없는 요청은 모두 404입니다. 개수는 비동기로 갱신하며 파일이 목록에서 사라진 뒤에도 삭제 누계를 유지합니다. processed는 현재 발견된 범위의 완료를 뜻하며 오래된 파일의 늦은 등록으로 범위와 상태가 다시 달라질 수 있습니다. 미등록 객체까지 삭제되었음을 보장하지 않습니다.
인증
Authorizationstring헤더필수시스템 액세스 토큰을 Bearer YOUR_SYSTEM_ACCESS_TOKEN 형식으로 사용합니다. 모델 API Key는 사용할 수 없고 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.scopestringsingle은 지정 파일 하나 삭제, all은 현재 계정의 기존 파일 전체 삭제입니다.
data.file_idstring | null단일 삭제는 파일 ID, 일괄 삭제는 null.
data.created_before_atstring | null일괄 삭제 생성 시각 상한. 해당 시각 포함, 단일 삭제는 null.
data.statestringpending: 접수; 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입니다.
공통 인증, 속도 제한, 오류 처리는 시작하기를 참고하세요.