curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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"
}
]
}
媒体库
列出已上传文件
GET /media/
GET
/
media
/
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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"
}
]
}
在管理 API 主机 (
api.scanova.io) 上列出账户自己上传的文件，使用您的原始管理 API 密钥进行身份验证。
GET https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
按检测到的文件类型筛选，例如
png。string
按用途标记筛选，例如
qr_logo。string
按文件扩展名筛选。
string
按 MIME 类型筛选。
boolean
筛选（不）属于批量媒体批次的文件。
string
在
original_name 中搜索。string
按
created、original_name 或 file_size 排序 —— 前缀 - 表示降序。默认值为 -created。string
以逗号分隔的允许字段列表，用于精简响应形状。
integer
页码。
integer
每页结果数，最多 100。
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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"
}
]
}
此端点不会直接拒绝未经身份验证的调用 —— 缺失或无效的 API 密钥只会将查询限制为不属于任何用户，因此您得到的是空结果集而不是
401。请始终发送您的密钥。相关内容
授权
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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.
查询参数
e.g. -created, original_name, file_size.
Comma-separated field allow-list for the response.
Max 100.
响应
200 - application/json
Paginated list of files.
此页面对您有帮助吗？