Skip to main content
Sube archivos a Whop para usarlos en cursos, foros, perfiles, disputas y más.

Cómo funcionan las subidas

La subida es un flujo de dos pasos, y el SDK ayuda con el primero:
  1. Crea un registro de archivo. files.create devuelve el id del nuevo archivo, además de una upload_url prefirmada y los upload_headers que debes enviar con ella.
  2. Envía los bytes tú mismo. Haz un PUT del contenido del archivo a upload_url con esos encabezados. El SDK no transfiere los bytes por ti.
Una vez que llegan los bytes, el archivo se procesa y su upload_status pasa a ready. Usa files.retrieve para consultar periódicamente hasta que esté en ready y, después, adjunta el id a un recurso y lee la url final. Para subir directamente desde el navegador sin que los bytes pasen por tu servidor, o para enviar un archivo grande por partes, consulta Subir archivos directamente.

Inicializar el SDK

Subir un archivo

Crea el registro y luego haz un PUT de los bytes a la URL prefirmada que se devuelve.

Archivos públicos y privados

Cada archivo que subes tiene una visibilidad que controla el acceso. Eliges la visibilidad en el momento de la subida y no puedes cambiarla después.
Establece la visibilidad antes de subir. Los archivos públicos se almacenan en caché en la CDN de Whop y cualquiera que tenga la URL puede acceder a ellos; no hay forma de revocar el acceso. Si el contenido es específico de un usuario o sensible, mantén el valor predeterminado private.

Subir un archivo público

Pasa una visibilidad public al crear el archivo y luego sube los bytes de la misma forma:
Adjuntar un archivo a un recurso lo mueve al almacenamiento que corresponde a la visibilidad propia de ese recurso. Una visibility explícita importa sobre todo para los archivos que enlazas directamente sin adjuntarlos.

Confirmar que la subida ha terminado

Después de que lleguen los bytes, el archivo se procesa de forma asíncrona. Obtenlo hasta que upload_status deje de ser pending y processing. Cuando sea ready, lee la url final. Cuando sea failed, detente y muestra el error.

Acceder a archivos privados

Las URL de los archivos privados caducan. Para obtener una URL nueva, vuelve a obtener el archivo por su ID:

Usar archivos subidos

Cuando el archivo esté en ready, pasa su id en cualquier llamada a la API que acepte archivos adjuntos:

Propiedades del archivo