Cabeçalhos Personalizados de Arquivos

Anexe cabeçalhos de metadados a arquivos para content-type, cache e dados personalizados da aplicação.

Anexar cabeçalhos de metadados a arquivos

Armazene metadados chave-valor personalizados junto aos arquivos — útil para Content-Type, diretivas de cache ou metadados personalizados da aplicação.

# Adicionar um único cabeçalho
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"}'

# Adicionar múltiplos cabeçalhos de uma 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"}
  ]}'

Os cabeçalhos são retornados com as respostas de arquivos e usados automaticamente ao servir arquivos (por exemplo, content-type determina o comportamento do navegador).