PUT naartoe stuurt. Het bestand is bruikbaar zodra die bytes in de opslag van Whop zijn aangekomen.
Dit is de onderliggende flow in twee stappen achter de methoden files.create en files.retrieve van de SDK. Gebruik hem wanneer je vanuit de browser uploadt (zodat de bytes nooit je server raken) of werkt in een taal zonder SDK. Zo verstuur je ook bestanden die zo groot zijn dat ze in meerdere delen moeten.
De
/files-endpoints vereisen API-versie 2026-08-21-1 of later. Elk request hieronder legt die vast met de header Api-Version-Date. Zie API-versies.De levenscyclus van een upload
Elke upload bestaat uit drie stappen, of het nu om één deel gaat of om meerdere:- Maak het bestandsrecord aan → Whop retourneert een presigned bestemming en het bestand begint als
pending. - Upload de bytes rechtstreeks naar de presigned URL’s.
- Poll Retrieve File totdat
upload_statusreadyis — dan zijnurlensizeingevuld en kan de ID van het bestand overal worden gekoppeld waar Whop een document accepteert.
url en size van een bestand blijven null totdat de verwerking klaar is. upload_status doorloopt pending → processing → ready (of failed).
Upload in één deel
Gebruik éénPUT voor alles onder een paar honderd megabyte.
1
Maak het bestand aan
Stuur de
filename en optioneel een visibility (standaard private). De upload_url in de response is waar de bytes naartoe gaan, en upload_headers zijn de headers die je ermee moet meesturen.2
Upload de bytes
Stuur de inhoud van het bestand met
PUT naar upload_url, met alle headers uit upload_headers. Dit request gaat rechtstreeks naar de bestandsopslag van Whop, niet naar api.whop.com, en bevat geen Whop-Authorization-header — de inloggegevens zitten in de presigned URL.3
Poll totdat het bestand klaar is
Haal het bestand op via de ID totdat
upload_status ready wordt. Het veld url bevat dan een downloadlink: een permanente CDN-URL als het bestand public is, of een ondertekende, verlopende URL als het private is.Multipart-upload
Upload grote bestanden in delen. Whop retourneert één presigned URL per deel. Je uploadt de delen (optioneel parallel) en laat Whop ze daarna samenvoegen. Multipart is verplicht boven 5 GB, omdat één uploadrequest niet groter mag zijn. Het is ook verstandig boven ~100 MB, waar één lange upload kwetsbaar is. Het bestand moet groter zijn dan 5 MB, omdat elk deel behalve het laatste minstens 5 MB moet zijn.1
Maak het bestand aan met multipart ingeschakeld
Geef
multipart: true en de totale byte_size mee, zodat Whop weet hoeveel presigned URL’s voor delen moeten worden geretourneerd. De response bevat een multipart_upload_id, één presigned url per part_number, en de multipart_chunk_size (in bytes) die elk deel behalve het laatste moet hebben.Multipart-uploads ondersteunen maximaal 10.000 delen van elk 5 MB — ongeveer 50 GB. Een
byte_size waarvoor meer delen nodig zouden zijn, wordt geweigerd met een 400.2
Upload elk deel en bewaar de ETag
Verdeel het bestand in stukken van
multipart_chunk_size bytes (het laatste deel mag kleiner zijn) en stuur elk stuk met PUT naar de url van het bijbehorende deel. Elke uploadresponse retourneert een ETag-header — bewaar die samen met het part_number, want je hebt beide nodig om af te ronden.3
Rond de upload af
Geef de
multipart_upload_id en het part_number + etag van elk deel door aan Complete File Multipart Upload. Whop voegt de delen samen tot het uiteindelijke bestand.4
Poll totdat het bestand klaar is
Haal, net als bij uploads in één deel, het bestand op totdat
upload_status ready is. De ID kan dan worden gekoppeld.Een zichtbaarheid kiezen
Je steltvisibility in bij het aanmaken en kunt die daarna niet meer wijzigen:
Openbare bestanden worden gecachet op het CDN van Whop en kunnen niet worden ingetrokken, dus houd de standaardwaarde
private aan voor alles wat gevoelig is. Zie Bestanden uploaden voor meer informatie.
Een geüpload bestand gebruiken
Zodra een bestandready is, geef je de id mee overal waar Whop een document accepteert — bijvoorbeeld als bewijs bij een geschil of als juridisch document van een account.
Volgende stappen
Bestanden uploaden (SDK)
Hoe de methoden
files.create en files.retrieve van de SDK deze flow omhullen.Create File
Volledige referentie voor request en response van het create-endpoint.
Complete File Multipart Upload
Referentie voor het samenvoegen van multipart-delen.
API-versies
Waarom de header
Api-Version-Date belangrijk is en hoe je die vastlegt.
