Skip to main content
Uploads bij Whop gaan rechtstreeks naar de opslag. Wanneer je Create File aanroept, ontvangt Whop je bytes niet via de API. In plaats daarvan maakt Whop een bestandsrecord aan en geeft een presigned upload-URL terug, waar je de bytes zelf met 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:
  1. Maak het bestandsrecord aan → Whop retourneert een presigned bestemming en het bestand begint als pending.
  2. Upload de bytes rechtstreeks naar de presigned URL’s.
  3. Poll Retrieve File totdat upload_status ready is — dan zijn url en size ingevuld en kan de ID van het bestand overal worden gekoppeld waar Whop een document accepteert.
De 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 één PUT 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.
De presigned URL verloopt een uur nadat hij is uitgegeven. Maak het bestand aan vlak voordat je uploadt, en vraag een nieuwe aan als een PUT na lange tijd mislukt met 403. URL’s voor delen van een multipart-upload verlopen eerder, na 15 minuten.
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.
Elk deel moet op volgorde worden vermeld, met precies de ETag die werd geretourneerd toen je het uploadde. Een onbekende multipart_upload_id of een niet-overeenkomende ETag levert een 400 op — upload het betreffende deel opnieuw en rond opnieuw af.
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 stelt visibility 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 bestand ready 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.