Skip to main content
Les téléversements Whop se font directement vers le stockage. Lorsque vous appelez Create File, Whop ne reçoit pas vos octets via l’API. Il crée un enregistrement de fichier et renvoie une URL de téléversement présignée vers laquelle vous envoyez vous-même les octets avec 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 :
  1. Créez l’enregistrement du fichier → Whop renvoie une destination présignée et le fichier démarre avec le statut pending.
  2. Téléversez les octets directement vers les URL présignées.
  3. Interrogez Retrieve File jusqu’à ce que upload_status vaille ready — url et size sont alors renseignés et l’ID du fichier peut être joint partout où Whop accepte un document.
Les champs 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 seul PUT 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.
L’URL présignée expire une heure après son émission. Créez le fichier juste avant de téléverser, et demandez-en une nouvelle si un PUT échoue avec une erreur 403 après un long délai. Les URL des parties d’un téléversement en plusieurs parties expirent plus tôt, au bout de 15 minutes.
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.
Chaque partie doit être listée, dans l’ordre, avec l’ETag exact renvoyé lors de son téléversement. Un multipart_upload_id inconnu ou un ETag qui ne correspond pas renvoie une erreur 400 — téléversez à nouveau la partie en cause et finalisez de nouveau.
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éfinissez visibility 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 est ready, 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.