Skip to main content
파일을 생성하면 미리 서명된(presigned) 업로드 대상이 반환됩니다. 해당 위치에 바이트를 업로드하면 파일이 ready 상태가 됩니다. Files API를 사용하여 파일을 생성하고, 콘텐츠를 스토리지에 직접 업로드하고(한 번의 PUT으로, 또는 대용량 파일의 경우 여러 파트로), 준비 상태를 폴링하면서 파일을 조회할 수 있습니다. 준비된 파일의 ID는 Whop이 파일을 허용하는 모든 곳에 첨부할 수 있습니다.

엔드포인트

속성

string
필수
파일의 ID이며, file_ 접두사로 시작합니다.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형입니다(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시각이며, ISO 8601 타임스탬프입니다.
number | null
필수
오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.
string | null
멀티파트 업로드의 ID이며, complete에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 인덱스(1부터 시작)입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형이며, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 제거되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 포함됩니다.
string
필수
파일의 업로드 수명 주기상 현재 위치입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 포함됩니다.
string | null
필수
파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명된 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
필수
이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
File