Cabeceras Personalizadas de Archivos

Adjunta cabeceras de metadatos a archivos para content-type, caché y datos personalizados de la aplicación.

Adjuntar cabeceras de metadatos a archivos

Almacena metadatos clave-valor personalizados junto a los archivos — útil para Content-Type, directivas de caché o metadatos personalizados de la aplicación.

# Agregar una sola cabecera
curl -X POST "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/headers?apiKey=<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "content-type", "value": "image/jpeg"}'

# Agregar múltiples cabeceras a la vez
curl -X POST "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/headers/bulk?apiKey=<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"bulk": [
    {"name": "content-type", "value": "image/jpeg"},
    {"name": "cache-control", "value": "max-age=31536000"},
    {"name": "x-custom-tag", "value": "foto-de-perfil"}
  ]}'

Las cabeceras se devuelven con las respuestas de archivos y se usan automáticamente al servir archivos (por ejemplo, content-type determina el comportamiento del navegador).