Subir un archivo

POST https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Content-Type: multipart/form-data

curl -X POST "https://api.scanova.io/media/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
  -F "file=@logo.png" \
  -F "in_use=qr_logo" \
  -F "category=custom-design"

{
  "id": 4821,
  "file": "media/uploads/104/2026/09/20260908_512873_logo.png",
  "upload": null,
  "file_name": "20260908_512873_logo.png",
  "size": 48213,
  "human_readable_size": "47.08 KB",
  "original_name": "logo.png",
  "bulk_media": null,
  "mime_type": "image/png",
  "file_type": "png",
  "in_use": "qr_logo",
  "category": "custom-design",
  "created": "2026-09-08T10:15:32.120Z",
  "modified": "2026-09-08T10:15:32.120Z"
}

​

Validación

• Extensión y tipo MIME deben estar ambos en la lista de permitidos de la categoría file_type detectada — una discrepancia (p. ej. una extensión .png en un archivo que en realidad es un PDF) se rechaza.
• Tamaño se comprueba contra el límite de la categoría — excepto para archivos pdf/doc, donde la cuota del plan DOCUMENT_FILE_SIZE de la cuenta (en MB) sustituye al límite estático.
• JavaScript (.js) subido se analiza para confirmar que es JS sintácticamente válido antes de la comprobación de tamaño.
• SVGs se escanean en busca de scripts incrustados y se rechazan si se encuentra alguno.
• Los archivos sin extensión se rechazan por completo.

​

Relacionado

• Listar archivos subidos — ver lo que ya se ha subido.
• Listar tipos de archivo permitidos — validar en el cliente antes de subir.
• Eliminar un archivo — eliminar uno.
• Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota que se aplican a este endpoint.