Archivos

AppShark permite cargar y administrar archivos multimedia y documentos por proyecto para incorporarlos en el chat o integrarlos dentro de las aplicaciones generadas.

Funcionalidades principales

• Carga y visualización previa integrada (imágenes, documentos PDF, video y audio)
• Control de cuota y espacio según tu suscripción
• Validación estricta de formatos y pesos máximos permitidos
• Direcciones URL públicas con identificadores UUID para incrustación directa
• Token de autenticación de API para operaciones desde la aplicación generada

Parámetros de almacenamiento del plan

Las condiciones de tu suscripción determinan si el almacenamiento está habilitado, el volumen global en megabytes (cuota compartida entre todos tus proyectos), el tamaño límite por archivo individual y las extensiones autorizadas.

Uso del gestor de archivos (File Manager)

1. Ingresa a la sección Files en el menú lateral.
2. Selecciona el proyecto correspondiente en el desplegable superior (el área de carga se activa únicamente cuando hay un proyecto seleccionado).
3. Arrastra los elementos o haz clic para buscarlos en tu equipo.
4. Aguarda a que concluya la barra de progreso de carga.

Desde esta misma pantalla podrás previsualizar recursos, eliminarlos o comprobar el porcentaje de almacenamiento ocupado.

Formatos admitidos y restricciones

Los formatos permitidos responden a la configuración del plan (imágenes, videos, audios, documentos PDF, archivos ZIP, texto simple o formato abierto). Archivos con capacidad de ejecución o riesgo de seguridad (como scripts PHP, archivos HTML ejecutables, código JavaScript o ejecutables de sistema) se encuentran restringidos en todo momento.

Enlaces de incrustación pública

Las direcciones URL públicas para incrustar recursos (/api/files/…) no exigen cabeceras de autorización, permitiendo su renderizado en etiquetas <img>. Cualquier persona que conozca el enlace podrá acceder al contenido; por consiguiente, deben gestionarse como recursos públicos y no como archivos confidenciales.

Archivos adjuntos en el chat

Al crear un proyecto o interactuar en el chat puedes adjuntar archivos o invocarlos escribiendo @ en el campo de texto. Para más detalles, consulta Chat e IA.

Acceso mediante API desde aplicaciones generadas

El token de acceso asignado al proyecto (disponible en Settings → Storage/API) permite autenticar las siguientes operaciones:

POST /api/app/{projectId}/files
GET  /api/app/{projectId}/files
GET  /api/app/{projectId}/files/{path}
DELETE /api/app/{projectId}/files/{fileId}

Métodos de envío del token compatibles: cabecera X-Project-Token, cabecera Authorization: Bearer [token] o parámetro en URL ?api_token=[token].

Acceso público por identificador UUID:

GET /api/files/{projectId}/{filename}

Ejemplo de carga mediante JavaScript:

async function uploadFile(file) {
  const formData = new FormData()
  formData.append('file', file)
  const response = await fetch('/api/app/PROJECT_ID/files', {
    method: 'POST',
    headers: { 'X-Project-Token': 'YOUR_PROJECT_TOKEN' },
    body: formData,
  })
  return response.json()
}

Si la suscripción del titular del proyecto deja de incluir almacenamiento, las peticiones de subida desde la aplicación web devolverán un código de respuesta 403.

Incidencias habituales

• Error al cargar — verifica que el archivo no supere el peso límite, que la extensión esté permitida y que dispongas de espacio suficiente.
• Cuota de almacenamiento alcanzada — elimina recursos innecesarios o actualiza tu plan de servicio.
• Enlace no disponible en el panel — genera nuevamente el enlace firmado desde el gestor (las URLs administrativas temporales expiran tras aproximadamente una hora); los enlaces directos por UUID son permanentes.