Skip to main content
Blob Storage guarda tus archivos, sirve los públicos desde una CDN y genera enlaces para los privados. Esta página te lleva de una clave de API a un archivo subido y un enlace de descarga, con curl. El almacenamiento está incluido en todos los planes: consulta Blob Storage para ver los planes, los precios y las preguntas frecuentes.

​
URL base

Todos los endpoints de esta referencia son relativos a:

​
Autenticación

Blob Storage acepta las mismas claves de API que la API de Square Cloud, en el encabezado Authorization. La clave necesita el scope blob:write para subir y blob:read para listar y descargar, y no puede estar restringida a aplicaciones concretas. Crea una en la configuración de seguridad de tu cuenta y guárdala en una variable de entorno:
Más sobre scopes y tokens de subida en Autenticación.

​
Subir un archivo

Object Post recibe el archivo como multipart/form-data y su nombre, sin extensión, en la query:
El archivo es público por defecto: url funciona de inmediato en un navegador o en una etiqueta <img>. Guarda el id tal como llega, ya que todas las demás rutas lo usan. Una sola solicitud acepta archivos de 512 bytes a 100 MB. Los archivos más grandes, de hasta 10 GiB, pasan por la subida por partes o por el gateway S3.

​
Subir un archivo privado

Añade private=true y el archivo no tendrá URL pública (url es null):

​
Descargar un archivo

Un archivo público se descarga desde su url. Para uno privado, Object Download firma un enlace temporal que funciona sin credenciales y redirige a él, así que curl -L guarda el archivo:
Reemplaza <id> por el id de la subida. Añade redirect=false para recibir el enlace como JSON y pasárselo a otra persona. Para enlaces que puedas revocar o proteger con contraseña, crea un enlace compartido.

​
Listar y eliminar archivos

Object List devuelve tus archivos página por página:
Objects Delete elimina un archivo, o hasta 100 en una sola solicitud:

​
Cuando algo falla

Los errores llegan como { "status": "error", "code": "..." }. Los que probablemente encuentres primero: Todos los códigos están en Errores.

​
Próximos pasos

SDK de Blob

Sube y gestiona archivos desde JavaScript, con las subidas por partes resueltas por ti.

Compatibilidad con S3

Usa aws-cli, boto3, rclone o cualquier SDK de AWS.

Enlaces y compartición

Enlaces temporales, enlaces compartidos y cuándo usar cada uno.

Subir desde el navegador

Permite que tus visitantes suban archivos sin exponer tu clave de API.