Blob Storage: ¿qué es y cómo usarlo?

En el desarrollo de aplicaciones modernas, gestionar archivos (imágenes, vídeos, documentos) directamente en el servidor de la aplicación puede consumir recursos preciosos y complicar el escalamiento. El Blob Storage de Square Cloud resuelve este problema ofreciendo un almacenamiento de objetos binarios (Binary Large Objects) totalmente serverless, con baja latencia y CDN incluida.

1. ¿Qué es y por qué usarlo?

El Blob Storage es un servicio de almacenamiento de activos diseñado para alta disponibilidad. A diferencia de un sistema de archivos tradicional, está optimizado para lectura rápida a través de una Red de Entrega de Contenido (CDN).

• Serverless: No necesitas gestionar discos ni volúmenes.
• Baja latencia: Gracias a la CDN, el contenido se sirve desde el punto de presencia más cercano al usuario.
• Eficiencia: Reduce la carga de I/O del servidor principal de tu aplicación o bot.

2. Control sobre los activos

Al subir un archivo al Blob, tienes control total sobre el comportamiento del activo:

• Expiración: Define un tiempo de vida para el archivo (ideal para archivos temporales).
• Nombre y prefijo: Organiza tus archivos en "carpetas" lógicas usando prefijos.
• Hash de seguridad: Genera un sufijo aleatorio para evitar que el enlace sea "adivinado" por terceros.
• Descarga automática: Opción para forzar al navegador a descargar el archivo en lugar de solo visualizarlo.

3. Límites y formatos soportados

El servicio permite el envío de archivos entre 1KB y 100MB. A continuación, los tipos de archivos aceptados categorizados por extensión:

Tienes una cuota gratuita de uso según tu plan. Consulta la tabla de abajo:

4. Estructura de la URL de acceso

Una vez que el archivo es enviado, queda disponible públicamente a través de una URL estandarizada. La estructura sigue este formato:

https://public-blob.squarecloud.dev/{id_cuenta_square}/{prefijo}/{filename}{_hash_seguridad}{extensión}

Ejemplo práctico:
Si tu ID es 123, el prefijo es banners, el archivo es promocion y tiene un hash:
https://public-blob.squarecloud.dev/123/banners/promocion_xyz789.jpg
Si optas por no definir prefijo ni hash, sin tiempo de expiración:
https://public-blob.squarecloud.dev/123/promocion.jpg

5. Cómo enviar archivos

Existen dos formas principales de interactuar con el Blob Storage:

Vía Dashboard

Ideal para la gestión manual. Solo accede a la pestaña Blob en tu panel, haz clic en Enviar nuevo objeto y rellena el formulario.

Vía API Pública

Para automatización, utiliza el endpoint de POST.

1. Información general

• Endpoint: https://blob.squarecloud.app/v1/objects
• Método: POST
• Autenticación: Clave de API en el Header.
• Rate Limit: 1/s

2. Parámetros de URL (Query Params)

Debes incluir las configuraciones del archivo directamente en la URL de la petición:

3. Cabeceras (Headers)

4. Cuerpo de la petición (Body)

El cuerpo debe utilizar el formato FormData conteniendo solo el archivo:

• Key: file
• Value: [Archivo binario]
• mimetype: mimetype del archivo (ej.: image/jpeg)

• Referencia de la API:
• Envío
• Eliminación
• Estadísticas

Consejo: Al enviar un archivo sin hash y sin tiempo de expiración, puedes actualizarlo enviando otro archivo del mismo tipo y con los mismos parámetros (prefix/nombre). Recuerda que hay un tiempo de caché por ser una CDN.

6. Buenas prácticas

• Organización: Usa siempre prefijos (ej.: profiles/, logs/) para evitar que la raíz de tu Blob quede desordenada.
• Caché y CDN: Recuerda que los activos en CDN se cachean. Si necesitas actualizar un archivo manteniendo el nombre, el uso de hashes de seguridad es altamente recomendado para evitar que el usuario vea la versión antigua.
• Seguridad: Aunque el enlace contiene el ID de tu cuenta, es público. No almacenes información confidencial sin cifrar.

Actualizado el: 13/06/2026