Descargas de producto

Archivos descargables adjuntos a un producto o variante (manuales, guías, archivos digitales).

Listar descargas

GET /api/v1/catalog/products/:id/downloads

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "product_id": "uuid",
      "variant_id": null,
      "file_name": "manual-usuario.pdf",
      "file_url": "https://cdn.example.com/files/manual.pdf",
      "file_size_bytes": 2048000,
      "download_limit": 5,
      "download_expiry_days": 30,
      "position": 0,
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ]
}

---

Crear descarga

POST /api/v1/catalog/products/:id/downloads

{
  "file_name": "manual-usuario.pdf",
  "file_url": "https://cdn.example.com/files/manual.pdf",
  "file_size_bytes": 2048000,
  "download_limit": 5,
  "download_expiry_days": 30
}

Campo	Requerido	Descripción
file_name	Sí	Nombre del archivo
file_url	Sí	URL de descarga
variant_id	No	UUID de variante específica (null = todo el producto)
file_size_bytes	No	Tamaño en bytes
download_limit	No	Máximo de descargas permitidas
download_expiry_days	No	Días hasta que expira el enlace

Respuesta 201: objeto ProductDownload completo.

---

Actualizar descarga

PATCH /api/v1/catalog/products/:id/downloads/:download_id

Todos los campos opcionales.

{
  "file_name": "manual-actualizado.pdf",
  "download_limit": 10
}

---

Eliminar descarga

DELETE /api/v1/catalog/products/:id/downloads/:download_id

Respuesta 204 No Content