Skip to main content
Téléversez des fichiers sur Whop pour les utiliser dans des cours, des forums, des profils, des litiges, et plus encore.

Fonctionnement des téléversements

Le téléversement se déroule en deux étapes, et le SDK vous aide pour la première :
  1. Créez un enregistrement de fichier. files.create renvoie l’id du nouveau fichier ainsi qu’une upload_url présignée et les upload_headers à envoyer avec.
  2. Envoyez vous-même les octets. Effectuez un PUT du contenu du fichier vers upload_url avec ces en-têtes. Le SDK ne transfère pas les octets à votre place.
Une fois les octets reçus, le fichier est traité et son upload_status passe à ready. Utilisez files.retrieve pour interroger le fichier jusqu’à ce qu’il soit ready, puis associez l’id à une ressource et lisez l’url finale. Pour téléverser directement depuis le navigateur afin que les octets ne transitent jamais par votre serveur, ou pour envoyer un fichier volumineux en plusieurs parties, consultez Téléverser des fichiers directement.

Initialiser le SDK

Téléverser un fichier

Créez l’enregistrement, puis effectuez un PUT des octets vers l’URL présignée renvoyée.

Fichiers publics et privés

Chaque fichier que vous téléversez possède une visibilité qui contrôle son accès. Vous choisissez la visibilité au moment du téléversement et ne pouvez pas la modifier ensuite.
Définissez la visibilité avant de téléverser. Les fichiers publics sont mis en cache sur le CDN de Whop et accessibles à toute personne disposant de l’URL — il est impossible de révoquer l’accès. Si le contenu est propre à un utilisateur ou sensible, conservez la valeur par défaut private.

Téléverser un fichier public

Transmettez une visibilité public lors de la création du fichier, puis téléversez les octets de la même manière :
Associer un fichier à une ressource le déplace vers le stockage correspondant à la visibilité de cette ressource. Une visibility explicite compte surtout pour les fichiers vers lesquels vous créez un lien direct sans les associer.

Confirmer la fin du téléversement

Une fois les octets reçus, le fichier est traité de manière asynchrone. Récupérez-le jusqu’à ce que upload_status quitte pending et processing. Lorsqu’il vaut ready, lisez l’url finale. Lorsqu’il vaut failed, arrêtez-vous et remontez l’erreur.

Accéder aux fichiers privés

Les URL des fichiers privés expirent. Pour obtenir une nouvelle URL, récupérez à nouveau le fichier par son ID :

Utiliser les fichiers téléversés

Une fois le fichier ready, transmettez son id dans tout appel API acceptant des pièces jointes :

Propriétés des fichiers