媒体 API
媒体 API 用于快照、缩略图、预览和其他二进制媒体访问。客户端要正确处理 Content-Type、缓存策略和文件不存在。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
Content-Type
不要假设所有图片都是 JPEG；按响应头处理。
404
媒体过期或尚未生成时可能返回 404，这和事件不存在不是一回事。
缓存
缩略图可适度缓存，实时快照应使用更短缓存。
权限
导出的敏感媒体不应通过永久公开 URL 暴露。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Media API
Media APIs serve snapshots, thumbnails, previews and other binary media. Clients must handle content types, caching and missing files.
Core behavior
This page is topic-specific rather than a generic placeholder.
Content-Type
Honor the response content type.
404
Missing/expired media may return 404 while metadata still exists.
Caching
Cache thumbnails more aggressively than live snapshots.
Access
Avoid permanent public URLs for sensitive media.
Verification and troubleshooting
- Record the current version/config before changes so rollback is possible.
- Verify both UI state and backend logs after the change.
- If only one camera/plugin is affected, isolate it before making global changes.
API multimedia
La API de medios sirve snapshots, miniaturas y previews; gestione Content-Type, caché y archivos ausentes.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Content-Type
Respete el tipo de respuesta.
404
El medio puede faltar aunque existan metadatos.
Caché
Cachee miniaturas más que snapshots en vivo.
Acceso
Evite URLs públicas permanentes.
Verificación y diagnóstico
- Registre versión/configuración antes de cambiar para poder revertir.
- Compruebe UI y logs del backend después.
- Si afecta a una sola cámara/plugin, aíslelo antes de cambios globales.