curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"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"
}
]
}
Biblioteca de medios
Listar archivos subidos
GET /media/
GET
/
media
/
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"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"
}
]
}
Lista los archivos subidos propios de la cuenta, en el host de la API de gestión (
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
GET https://api.scanova.io/media/
Authorization: YOUR_API_KEY
string
Filtra por tipo de archivo detectado, p. ej.
png.string
Filtra por indicador de uso, p. ej.
qr_logo.string
Filtra por extensión de archivo.
string
Filtra por tipo MIME.
boolean
Filtra archivos que (no) forman parte de un lote de medios masivos.
string
Busca en
original_name.string
Ordena por
created, original_name o file_size — anteponga - para orden descendente. El valor predeterminado es -created.string
Lista separada por comas de campos permitidos, para reducir la forma de la respuesta.
integer
Número de página.
integer
Resultados por página, máximo 100.
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"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"
}
]
}
Este endpoint no rechaza directamente las llamadas no autenticadas — una clave de API ausente o inválida simplemente restringe la consulta a ningún usuario, por lo que obtendrá un conjunto de resultados vacío en lugar de un
401. Envíe siempre su clave.Relacionado
- Subir un archivo — añadir uno nuevo.
- Listar tipos de archivo permitidos — las restricciones que deben cumplir las subidas.
- Obtener un archivo — obtener uno por id.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota que se aplican a este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Parámetros de consulta
e.g. -created, original_name, file_size.
Comma-separated field allow-list for the response.
Max 100.
Respuesta
200 - application/json
Paginated list of files.
¿Esta página le ayudó?