API 참조

관리형 파일 조회

GET/v1/files/{file_id}

동일 계정/키의 과거 파일입니다. 할당량이 소진된 유효한 키는 허용하지만 폐기/만료된 키는 거부합니다. 다운로드에는 ready가 필요하며 참조 중 삭제는 409를 반환합니다. retry는 원래 결과 저장만 재시도하고 생성하지 않습니다. 일반 API는 일 단위 보관을, 영구 보관 작업은 참조 보호를 사용하며 expires_at=0은 고정 만료 시각이 없음을 뜻합니다.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

file_idstring필수
동일 키 소유의 관리형 파일 공개 ID입니다.

응답과 오류

HTTP 200

관리형 파일 조회 성공

application/json

유형: object
필수 필드: idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at

idstring필수
해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
source_kindstring필수
파일 소스 분류이며 수명 주기와 참조 보호 규칙을 결정합니다.
source_indexinteger필수
원본 결과 항목 인덱스입니다.
modelstring필수
현재 키의 카탈로그에 있는 공개 모델 ID입니다.
statusstring필수
waiting/pending/archiving/ready/failed/deleting 등의 백그라운드 저장 단계입니다. 다운로드 URL은 ready 이후에만 사용할 수 있습니다.
mime_typestring필수
검증된 파일 MIME 유형입니다.
file_namestring필수
공개 다운로드 파일명입니다.
sha256string선택 사항
확정된 경우 반환하는 보관 콘텐츠의 SHA-256입니다.
size_bytesinteger필수
바이트 단위 파일 크기입니다.
error_codestring선택 사항
분기 로직에 사용할 수 있는 공개 오류 코드입니다.
created_atinteger필수
Unix 초 단위 생성 시각입니다.
updated_atinteger필수
Unix 초 단위 마지막 갱신 시각입니다.
expires_atinteger필수
Unix 초이며 0은 장기 보관을 뜻합니다. 일반 API는 배포 환경의 일 단위 보관 정책을 따릅니다. 영구 보관 이미지/동영상은 참조로 결과를 보호하며 삭제 후에도 요금과 멱등성 기록은 남습니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항