API 참조

단기 파일 다운로드 URL 받기

GET/v1/files/{file_id}/download-url

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

재생과 다운로드

단기 다운로드 URL을 요청하기 전에 파일 상태를 읽으세요. URL을 받아도 저장 준비가 완료되기 전에 파일을 사용할 수는 없습니다. 원래 API 키는 GloopAPI에만 보내고 반환된 HTTPS 주소에서 다운로드할 때는 첨부하지 마세요.

영구 보관 동영상은 단기 객체 스토리지 URL로 네이티브 Range 재생을 지원합니다. 일반 동영상 콘텐츠 경로의 전체 GET은 이 플레이어 흐름과 다른 전송 방식입니다. 링크가 만료되면 URL을 다시 받으세요. 링크 갱신으로 만료되거나 삭제된 파일을 복구할 수는 없습니다.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

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

응답과 오류

HTTP 200

단기 파일 다운로드 URL 조회 성공

application/json

유형: object
필수 필드: urlexpires_at

urlstring필수
단기 서명 다운로드 URL입니다. 노출하거나 장기간 보관하지 마세요.

형식
"uri"
expires_atinteger필수
Unix 초입니다.

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선택 사항