PUT. El archivo se puede usar en cuanto esos bytes llegan al almacenamiento de Whop.
Este es el flujo de dos pasos sin procesar que hay detrás de los métodos files.create y files.retrieve del SDK. Recurre a él cuando subas desde el navegador (para que los bytes nunca pasen por tu servidor) o trabajes en un lenguaje sin SDK. También es la forma de enviar archivos lo bastante grandes como para necesitar una subida multiparte.
Los endpoints
/files requieren la versión de la API 2026-08-21-1 o posterior. Cada solicitud de abajo la fija con la cabecera Api-Version-Date. Consulta Versiones de la API.El ciclo de vida de una subida
Cada subida consta de tres pasos, tanto si es de una parte como de muchas:- Crea el registro del archivo → Whop devuelve un destino prefirmado y el archivo empieza como
pending. - Sube los bytes directamente a las URL prefirmadas.
- Consulta periódicamente Retrieve File hasta que
upload_statusseaready; entoncesurlysizese rellenan y el ID del archivo se puede adjuntar en cualquier lugar donde Whop acepte un documento.
url y size de un archivo siguen siendo null hasta que termina el procesamiento. upload_status pasa por pending → processing → ready (o failed).
Subida de una sola parte
Usa un únicoPUT para cualquier archivo de menos de unos cientos de megabytes.
1
Crea el archivo
Envía el
filename y, opcionalmente, una visibility (private de forma predeterminada). La upload_url de la respuesta es adonde van los bytes, y upload_headers son las cabeceras que debes enviar con ellos.2
Sube los bytes
Envía con
PUT el contenido del archivo a upload_url, incluidas todas las cabeceras de upload_headers. Esta solicitud va directamente al almacenamiento de archivos de Whop, no a api.whop.com, y no lleva ninguna cabecera Authorization de Whop: las credenciales van incluidas en la URL prefirmada.3
Consulta hasta que esté listo
Obtén el archivo por su ID hasta que
upload_status pase a ready. El campo url contiene entonces un enlace de descarga: una URL permanente de la red de distribución de contenido cuando el archivo es public, o una URL firmada que caduca cuando es private.Subida multiparte
Para archivos grandes, sube por partes. Whop devuelve una URL prefirmada por parte. Las subes (opcionalmente en paralelo) y luego le indicas a Whop que las ensamble. La subida multiparte es obligatoria por encima de 5 GB, ya que una sola solicitud de subida no puede superar ese tamaño. También es buena idea por encima de unos 100 MB, donde una subida larga es frágil. El archivo debe ser mayor de 5 MB, ya que todas las partes excepto la última deben tener al menos 5 MB.1
Crea el archivo con multiparte habilitado
Pasa
multipart: true y el byte_size total para que Whop sepa cuántas URL de partes prefirmadas devolver. La respuesta lleva un multipart_upload_id, una url prefirmada por cada part_number y el multipart_chunk_size (en bytes) que debe tener cada parte excepto la última.Las subidas multiparte admiten como máximo 10.000 partes de 5 MB cada una, unos 50 GB. Un
byte_size que necesitaría más partes se rechaza con un 400.2
Sube cada parte y guarda su ETag
Divide el archivo en fragmentos de
multipart_chunk_size bytes (la última parte puede ser más pequeña) y envía con PUT cada fragmento a la url de la parte correspondiente. Cada respuesta de subida devuelve una cabecera ETag; guárdala junto al part_number, ya que necesitarás ambos para terminar.3
Completa la subida
Devuelve el
multipart_upload_id y el part_number + etag de cada parte a Complete File Multipart Upload. Whop ensambla las partes en el archivo final.4
Consulta hasta que esté listo
Al igual que con las subidas de una sola parte, obtén el archivo hasta que
upload_status sea ready. Entonces el ID estará listo para adjuntarse.Elegir una visibilidad
visibility se establece al crear el archivo y no se puede cambiar después:
Los archivos públicos se almacenan en caché en la CDN de Whop y no se pueden revocar, así que mantén el valor predeterminado
private para todo lo que sea sensible. Consulta Subir archivos para obtener más información.
Usar un archivo subido
Cuando un archivo estéready, pasa su id en cualquier lugar donde Whop acepte un documento, por ejemplo las pruebas de una disputa o los documentos legales de una cuenta.
Próximos pasos
Subir archivos (SDK)
Cómo envuelven este flujo los métodos
files.create y files.retrieve del SDK.Create File
Referencia completa de la solicitud y la respuesta del endpoint de creación.
Complete File Multipart Upload
Referencia para ensamblar las partes multiparte.
Versiones de la API
Por qué importa la cabecera
Api-Version-Date y cómo fijarla.
