PUT. Le fichier devient utilisable dès que ces octets arrivent dans le stockage de Whop.
Il s’agit du flux brut en deux étapes qui se cache derrière les méthodes files.create et files.retrieve du SDK. Utilisez-le lorsque vous téléversez depuis le navigateur (afin que les octets ne passent jamais par votre serveur) ou que vous travaillez dans un langage sans SDK. C’est aussi ainsi que vous envoyez des fichiers suffisamment volumineux pour nécessiter un téléversement en plusieurs parties.
Les endpoints
/files nécessitent la version d’API 2026-08-21-1 ou ultérieure. Chaque requête ci-dessous l’épingle avec l’en-tête Api-Version-Date. Consultez Versions de l’API.Le cycle de vie d’un téléversement
Chaque téléversement comporte trois étapes, qu’il s’agisse d’une seule partie ou de plusieurs :- Créez l’enregistrement du fichier → Whop renvoie une destination présignée et le fichier démarre avec le statut
pending. - Téléversez les octets directement vers les URL présignées.
- Interrogez Retrieve File jusqu’à ce que
upload_statusvailleready—urletsizesont alors renseignés et l’ID du fichier peut être joint partout où Whop accepte un document.
url et size d’un fichier restent à null jusqu’à la fin du traitement. upload_status passe de pending → processing → ready (ou failed).
Téléversement en une seule partie
Utilisez un seulPUT pour tout fichier de moins de quelques centaines de mégaoctets.
1
Créer le fichier
Envoyez le
filename et, éventuellement, une visibility (private par défaut). Le champ upload_url de la réponse indique où envoyer les octets, et upload_headers contient les en-têtes que vous devez envoyer avec eux.2
Téléverser les octets
Envoyez le contenu du fichier vers
upload_url avec PUT, en incluant chaque en-tête de upload_headers. Cette requête est adressée directement au stockage de fichiers de Whop, et non à api.whop.com, et ne comporte aucun en-tête Authorization Whop — les identifiants sont intégrés à l’URL présignée.3
Interroger jusqu'à ce que le fichier soit prêt
Récupérez le fichier par son ID jusqu’à ce que
upload_status passe à ready. Le champ url contient alors un lien de téléchargement : une URL permanente de réseau de diffusion de contenu lorsque le fichier est public, ou une URL signée qui expire lorsqu’il est private.Téléversement en plusieurs parties
Pour les fichiers volumineux, téléversez-les en plusieurs parties. Whop renvoie une URL présignée par partie. Vous les téléversez (éventuellement en parallèle), puis vous demandez à Whop de les assembler. Le téléversement en plusieurs parties est obligatoire au-delà de 5 Go, car une seule requête de téléversement ne peut pas dépasser cette taille. Il est également recommandé au-delà d’environ 100 Mo, où un long téléversement unique est fragile. Le fichier doit dépasser 5 Mo, car chaque partie, à l’exception de la dernière, doit faire au moins 5 Mo.1
Créer le fichier avec le téléversement en plusieurs parties activé
Transmettez
multipart: true et la taille totale byte_size afin que Whop sache combien d’URL de parties présignées renvoyer. La réponse contient un multipart_upload_id, une url présignée par part_number, et le multipart_chunk_size (en octets) que doit respecter chaque partie, à l’exception de la dernière.Les téléversements en plusieurs parties prennent en charge au maximum 10 000 parties de 5 Mo chacune — soit environ 50 Go. Un
byte_size qui nécessiterait davantage de parties est refusé avec une erreur 400.2
Téléverser chaque partie et récupérer son ETag
Découpez le fichier en blocs de
multipart_chunk_size octets (la dernière partie peut être plus petite) et envoyez chaque bloc avec PUT vers l’url de la partie correspondante. Chaque réponse de téléversement renvoie un en-tête ETag — conservez-le avec le part_number, vous aurez besoin des deux pour terminer.3
Finaliser le téléversement
Renvoyez le
multipart_upload_id ainsi que le part_number + etag de chaque partie à Complete File Multipart Upload. Whop assemble les parties pour former le fichier final.4
Interroger jusqu'à ce que le fichier soit prêt
Comme pour les téléversements en une seule partie, récupérez le fichier jusqu’à ce que
upload_status vaille ready. L’ID peut alors être joint.Choisir une visibilité
Vous définissezvisibility lors de la création et ne pouvez plus la modifier ensuite :
Les fichiers publics sont mis en cache sur le CDN de Whop et ne peuvent pas être révoqués : conservez donc la valeur par défaut
private pour tout contenu sensible. Consultez Téléverser des fichiers pour en savoir plus.
Utiliser un fichier téléversé
Une fois qu’un fichier estready, transmettez son id partout où Whop accepte un document — par exemple comme preuve dans un litige ou parmi les documents juridiques d’un compte.
Étapes suivantes
Téléverser des fichiers (SDK)
Comment les méthodes
files.create et files.retrieve du SDK encapsulent ce flux.Create File
Référence complète des requêtes et réponses de l’endpoint de création.
Complete File Multipart Upload
Référence pour l’assemblage des parties d’un téléversement en plusieurs parties.
Versions de l'API
Pourquoi l’en-tête
Api-Version-Date est important et comment l’épingler.
