开放接口平台 · 统一身份认证
本平台与全媒体媒资生产主站共用同一套用户权限体系,需完成身份核验后方可查阅接口规范与调试。
或使用访问令牌直接验证
全媒体生产归档媒资系统
开放接口平台 · Open API ● 生产就绪 (v1.4)
身份凭据:
← 返回媒资工作台
全媒体生产归档媒资系统 · OpenAPI 接口规范

面向全台业务制作网、新闻演播室、融媒体矩阵分发及第三方系统集成,提供标准的 RESTful JSON 开放接口。支持物理文件热汇聚、多模态 AI 智能检索、广播级分级审签、选片车一键直通剪辑工程与热温冷存储生命周期管理。

基准 URL: http://127.0.0.1:4173/api
认证方式: Session Cookie 或 Authorization: Bearer <Token>
数据格式: application/json (UTF-8)
在线调试: 已与当前本地实例实时联通
一、系统探针与状态
GET /api/open/monitor/health 系统健康探针与微服务运行状态

提供系统级高可用心跳检测,汇报数据库连接池、分布式对象存储、消息总线与 GPU/CPU 转码节点的在线状态与延迟。

请求参数
无需任何参数
响应示例 (200 OK)
{
  "status": "HEALTHY",
  "system_role": "全媒体大生产与深度归档中心资源库",
  "db_cluster": { "status": "ONLINE", "latency_ms": 1.2 },
  "object_storage": { "status": "ONLINE", "available_pb": 2.4 },
  "transcode_pipeline": { "nodes_online": 4, "active_jobs": 2 },
  "api_version": "v1.4.0"
}
在线调试与请求体验
GET /api/state 获取全系统业务字典、用户身份与配置

获取当前租户的全局媒资目录树、分类字典、角色权限定义及当前登录用户的 profile 数据。

请求参数
需登录会话凭据 (Cookie / Bearer)
响应示例 (200 OK)
{
  "user": { "id": "admin", "name": "系统管理员", "role": "admin" },
  "roles": ["admin", "editor", "reviewer", "producer"],
  "stats": { "total_assets": 81, "running_tasks": 4 }
}
在线调试与请求体验
二、生产入库与采集收录
GET /api/watchfolders 查询生产物理监控目录规则列表

获取广播电视制作网络中的物理热投递监控目录配置,包括挂载路径、目标媒资分类、自动触发的 AI 质检与转码规则流水线。

响应示例 (200 OK)
[
  {
    "id": "wf-01",
    "name": "4K超高清摄像母带热投递",
    "path": "/Volumes/MAM_Dropzone/4K_Raw",
    "status": "active",
    "target_folder": "4K航拍空镜母带",
    "pipeline": ["asr", "qc", "faces"]
  }
]
应用场景
前线记者拍完素材后直接拷贝至非编网共享盘,系统后台以 Inotify / FSEvents 机制毫秒级捕获落盘事件并自动触发入库编目。
在线调试与请求体验
POST /api/watchfolders/scan 即刻触发指定物理监控目录扫描

强制立即对指定的监控路径执行物理文件树深度比对,快速发现新放入的大文件并推入入库队列。

请求 Body (JSON)
{
  "id": "wf-01"
}
响应示例 (200 OK)
{
  "status": "success",
  "scanned_files": 12,
  "new_queued": 2,
  "elapsed_ms": 38
}
在线调试与请求体验
GET /api/live/channels 演播室与卫星信号基带收录通道

查询演播室主控、卫星传输网与现场外采回传流的实时收录通道状态,支持边录边编(Growing File)。

在线调试与请求体验
GET /api/wire/items 国家通讯社与电报资讯轮巡流

对接新华社、央视快讯等权威通稿源,支持实时接收外部文字与广播级快讯,一键转为生产专题选题。

在线调试与请求体验
三、生产媒资与素材库管理
GET /api/assets 资产多维检索与全属性列表

核心资产查询接口。支持按媒体类型(视频/图片/音频/文档)、密级范围、审核状态、目录树节点、关键词模糊/精确召回及分页。

Query 查询参数
参数名类型必填说明
typestring可选媒体类型,如 视频、图片、音频、文档
qstring可选关键字模糊检索(标题、编目描述、时间码字幕)
folderstring可选指定目录节点 ID
limitnumber可选单页条数,默认 50,最大 200
在线调试与请求体验
POST /api/action 资产核心业务操作总线

标准统一业务调度接口。通过 action 参数分发:包括 delete_assets (移入回收站)、restore_assets (恢复资产)、purge_assets (彻底销毁)、person_create (录入人物)、topic_create (创建专题) 等。

请求 Body 示例 (更新编目)
{
  "action": "update_asset",
  "id": "008bbcbad6a93a73",
  "title": "超级工程:深中通道全线贯通",
  "description": "重大工程建设纪实"
}
响应示例 (200 OK)
{
  "ok": true,
  "msg": "资产编目更新成功"
}
在线调试与请求体验
GET /api/download 广播级素材安全分发与下载

根据资产 ID 与授权范围,提供原格式母带(ProRes / XAVC)或轻量代理码流(H.264 MP4)的安全下载直链。

四、智能多模态检索
POST /api/nle-export 选片车素材秒级导出剪辑工程 (FCPXML / Premiere)

将智能检索选片车中的镜头切片打点(In/Out 点与时间码),瞬间打包生成 Final Cut Pro 或 Adobe Premiere 剪辑工程 XML,剪辑师导入后时间线上即直接对齐切片素材。

五、审片质检与协同流转
GET /api/my/todos 当前登录用户的协同待办与审片工单

获取分配给当前用户的待办任务列表,包含待三审素材、专题会签审核及质检异常待确认条目。

在线调试与请求体验
POST /api/approvals/review 广播级三级审签裁决 (通过/驳回)

责任编辑或值班主编对送审素材进行三级审签把关,附带电子签名与审核评审意见。

六、处理任务流水线
GET /api/tasks 转码、技审与 AI 感知任务状态列表

查询后台异步流水线中的所有运行中、已完成与异常任务(包括 720p/1080p 代理码率转码、ASR 语音转写、OCR 字符提取与人脸特征提取)。

在线调试与请求体验
POST /api/tasks/retry 失败或超时任务断点一键重试

针对转码网络中断或 AI 引擎超时造成的失败任务,重置状态并重新分配至空闲工作节点重试。

七、渠道分发与交换包
POST /api/open/publish/dispatch 融媒体全渠道矩阵快速分发

将已完成终审合规的融媒体资产推送至外部官方媒体平台(微信公众号、官方微博、抖音短视频、客户端 APP)。

请求 Body (JSON)
{
  "asset_id": "008bbcbad6a93a73",
  "channels": ["weibo", "wechat", "douyin"],
  "publish_title": "重大工程突破发布",
  "timing": "now"
}
响应示例 (200 OK)
{
  "success": true,
  "dispatch_id": "disp_88921b",
  "dispatched_channels": ["weibo", "wechat", "douyin"],
  "status": "QUEUED"
}
POST /api/exchange-export 台际广播标准资产交换包构建 (BXF/MXF)

严格遵循国家广电 GY/T 标准,将指定素材与其多级编目 XML、质检合规报告、台词时间码与数字水印打包为标准台际节目交换包。

八、存储台账与分级 (HSM)
GET /api/dashboard/stats 存储总容量水位与资产统计大盘

提供全台媒资总库的实时资产部数、总字节数、各部门/个人配额占用及热温冷存储池容量水位统计。

在线调试与请求体验
POST /api/archive/tier-migrate 大归档分级存储层间迁移 (HSM Tiering)

根据资产热度、保存年限或密级策略,将资产在「生产热存储 (SAN)」、「近线温存储 (NAS)」与「离线冷存储 (磁带库/蓝光)」之间自动或手动迁移。

请求 Body (JSON)
{
  "asset_id": "008bbcbad6a93a73",
  "target_tier": "冷存储 (磁带库/冷归档)",
  "reason": "超过365天生产窗口期,执行历史资料永久冷归档"
}
响应示例 (200 OK)
{
  "success": true,
  "asset_id": "008bbcbad6a93a73",
  "tier": "冷存储 (磁带库/冷归档)",
  "migrated_at": "2026-09-26 18:00:00"
}
在线调试与请求体验