Skip to main content
코스, 포럼, 프로필, 분쟁 등에서 사용할 파일을 Whop에 업로드하세요.

업로드 작동 방식

업로드는 두 단계 흐름이며, SDK는 첫 번째 단계를 도와줍니다:
  1. 파일 레코드를 생성합니다. files.create는 새 파일의 id와 함께 미리 서명된 upload_url 및 함께 보낼 upload_headers를 반환합니다.
  2. 바이트를 직접 전송합니다. 해당 헤더와 함께 파일 내용을 upload_url로 PUT하세요. SDK는 바이트를 대신 전송하지 않습니다.
바이트가 도착하면 파일이 처리되고 upload_status가 ready가 됩니다. files.retrieve로 ready가 될 때까지 폴링한 다음, id를 리소스에 첨부하고 최종 url을 읽으세요. 바이트가 서버를 거치지 않도록 브라우저에서 바로 업로드하거나 큰 파일을 여러 부분으로 나누어 보내려면 파일 직접 업로드를 참고하세요.

SDK 초기화

파일 업로드

레코드를 생성한 다음, 반환된 미리 서명된 URL로 바이트를 PUT하세요.

공개 및 비공개 파일

업로드하는 모든 파일에는 접근을 제어하는 공개 범위가 있습니다. 공개 범위는 업로드 시점에 선택하며 나중에 변경할 수 없습니다.
업로드하기 전에 공개 범위를 설정하세요. 공개 파일은 Whop의 CDN에 캐시되며 URL이 있는 누구나 접근할 수 있습니다 — 접근을 취소할 방법이 없습니다. 콘텐츠가 사용자별이거나 민감한 경우 기본값인 private를 유지하세요.

공개 파일 업로드

파일을 생성할 때 public 공개 범위를 전달한 다음, 같은 방식으로 바이트를 업로드하세요:
파일을 리소스에 첨부하면 해당 리소스의 공개 범위에 맞는 스토리지로 파일이 이동합니다. 명시적인 visibility는 주로 첨부하지 않고 직접 링크하는 파일에 중요합니다.

업로드 완료 확인

바이트가 도착한 후 파일은 비동기적으로 처리됩니다. upload_status가 pending 및 processing을 벗어날 때까지 파일을 조회하세요. ready가 되면 최종 url을 읽으세요. failed가 되면 중단하고 오류를 표시하세요.

비공개 파일 접근

비공개 파일 URL은 만료됩니다. 새 URL을 받으려면 ID로 파일을 다시 조회하세요:

업로드된 파일 사용

파일이 ready가 되면 파일 첨부를 허용하는 모든 API 호출에 해당 id를 전달하세요:

파일 속성