PUT. Filen kan bruges, så snart disse bytes er landet i Whops lager.
Dette er det rå totrinsforløb bag SDK’ets metoder files.create og files.retrieve. Brug det, når du uploader fra browseren (så bytes aldrig rører din server) eller arbejder i et sprog uden SDK. Det er også sådan, du sender filer, der er store nok til at kræve multipart.
/files-endpoints kræver API-version 2026-08-21-1 eller nyere. Hver forespørgsel nedenfor fastlåser den med Api-Version-Date-headeren. Se API-versioner.Uploadens livscyklus
Hver upload består af tre trin, uanset om den er i én del eller mange:- Opret filposten → Whop returnerer en forhåndssigneret destination, og filen starter som
pending. - Upload bytes direkte til de forhåndssignerede URL’er.
- Poll Retrieve File, indtil
upload_statuserready— så erurlogsizeudfyldt, og filens ID kan vedhæftes overalt, hvor Whop accepterer et dokument.
url og size forbliver null, indtil behandlingen er færdig. upload_status går fra pending → processing → ready (eller failed).
Upload i én del
Brug en enkeltPUT til alt under et par hundrede megabyte.
1
Opret filen
Send
filename og eventuelt en visibility (private som standard). Svarets upload_url er der, hvor bytes skal sendes hen, og upload_headers er de headere, du skal sende med dem.2
Upload bytes
Send filens indhold med
PUT til upload_url, og send alle headere fra upload_headers med. Denne forespørgsel går direkte til Whops fillager, ikke til api.whop.com, og har ingen Whop Authorization-header — legitimationsoplysningerne er indbygget i den forhåndssignerede URL.3
Poll, indtil den er klar
Hent filen via dens ID, indtil
upload_status bliver ready. Feltet url indeholder så et downloadlink: en permanent CDN-URL, når filen er public, eller en signeret URL, der udløber, når den er private.Multipart-upload
Store filer uploades i dele. Whop returnerer én forhåndssigneret URL pr. del. Du uploader dem (eventuelt parallelt) og beder derefter Whop om at samle dem. Multipart er påkrævet over 5 GB, da en enkelt upload-forespørgsel ikke kan overstige det. Det er også en god idé over ~100 MB, hvor én lang upload er skrøbelig. Filen skal være større end 5 MB, da alle dele undtagen den sidste skal være mindst 5 MB.1
Opret filen med multipart aktiveret
Angiv
multipart: true og den samlede byte_size, så Whop ved, hvor mange forhåndssignerede del-URL’er der skal returneres. Svaret indeholder et multipart_upload_id, én forhåndssigneret url pr. part_number og multipart_chunk_size (bytes), som hver del undtagen den sidste skal have.Multipart-uploads understøtter højst 10.000 dele på hver 5 MB — omkring 50 GB. En
byte_size, der ville kræve flere dele, afvises med en 400.2
Upload hver del, og gem dens ETag
Del filen op i bidder på
multipart_chunk_size bytes (den sidste del må være mindre), og send hver bid med PUT til den tilsvarende dels url. Hvert upload-svar returnerer en ETag-header — gem den sammen med part_number, da du skal bruge begge for at afslutte.3
Fuldfør uploaden
Send
multipart_upload_id og hver dels part_number + etag tilbage til Complete File Multipart Upload. Whop samler delene til den endelige fil.4
Poll, indtil den er klar
Ligesom ved uploads i én del skal du hente filen, indtil
upload_status er ready. ID’et er så klar til at blive vedhæftet.Valg af synlighed
Du angivervisibility, når filen oprettes, og kan ikke ændre den bagefter:
Offentlige filer caches på Whops CDN og kan ikke tilbagekaldes, så behold standardværdien
private til alt følsomt. Se Upload filer for mere.
Brug af en uploadet fil
Når en fil erready, kan du angive dens id overalt, hvor Whop accepterer et dokument — for eksempel beviser i en tvist eller en kontos juridiske dokumenter.
Næste trin
Upload filer (SDK)
Hvordan SDK’ets metoder
files.create og files.retrieve pakker dette forløb ind.Create File
Komplet reference for forespørgsel og svar til create-endpointet.
Complete File Multipart Upload
Reference til samling af multipart-dele.
API-versioner
Hvorfor
Api-Version-Date-headeren er vigtig, og hvordan du fastlåser den.
