Skip to main content
La création d’un fichier renvoie une destination présignée ; téléversez-y les octets et le fichier passe à l’état ready. Utilisez l’API Fichiers pour créer un fichier, téléverser son contenu directement vers le stockage (en un seul PUT, ou en plusieurs parties pour les fichiers volumineux), et le récupérer en interrogeant régulièrement son état de disponibilité. L’ID d’un fichier prêt peut être joint partout où Whop accepte des fichiers.

Endpoints

Attributs

string
requis
L’ID du fichier, préfixé par file_.
string | null
requis
Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu’il n’est pas disponible ou qu’il a été supprimé par la modération.
string | null
requis
Le type MIME du fichier d’origine, par exemple application/pdf. Il est conservé lorsque la modération supprime le fichier.
string
requis
Date de création du fichier, sous forme d’horodatage ISO 8601.
number | null
requis
Durée de l’audio ou de la vidéo en secondes. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
string | null
requis
Le nom de fichier d’origine, extension comprise.
integer | null
requis
Hauteur de l’image ou de la vidéo en pixels. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
integer | null
La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements multiparties.
string | null
L’ID du téléversement multipartie, à renvoyer à complete. Présent uniquement à la création, et uniquement pour les téléversements multiparties.
object[] | null
L’URL présignée de chaque partie. Présent uniquement à la création, et uniquement pour les téléversements multiparties.

Propriétés

integer
requis
L’index (commençant à 1) de cette partie dans le téléversement multipartie.
string
requis
L’URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
string
requis
Le type de cet objet, toujours file.
boolean
requis
Indique si la modération a supprimé le fichier. Lorsque true, url sert une image de remplacement. filename, size et content_type décrivent toujours le fichier d’origine.
integer | null
requis
La taille du fichier en octets. null tant que le téléversement n’est pas terminé.
object
En-têtes à envoyer avec le PUT de téléversement. Présent uniquement à la création.
string
requis
L’étape du cycle de téléversement à laquelle se trouve le fichier.Options disponibles : pending, processing, ready, failed
string | null
URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent uniquement à la création, et uniquement pour les téléversements en une seule partie.
string | null
requis
Une URL pour télécharger le fichier. Les fichiers publics reçoivent une URL CDN permanente, et les fichiers privés une URL signée qui expire. null tant que le téléversement n’est pas terminé. Lorsque la modération supprime le fichier, une URL d’image de remplacement.
string
requis
Les fichiers public sont servis depuis une URL CDN non signée. Les fichiers private sont servis depuis une URL signée qui expire.Options disponibles : public, private
string | null
requis
URL de la forme d’onde audio. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
integer | null
requis
Largeur de l’image ou de la vidéo en pixels. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
File