TIMERS STUDIO
MASTER YOUR FLOW

53个端点:如何自动化你的整场演出

OpenAPI 3.1、四个安全范围、SSE流,以及与n8n、vMix和OBS的真实自动化案例。

· 技术解析 · 11 min read

每个制作团队的成长过程中都有一个时刻,主控室里从思考单个工具转向思考系统。计时器不再仅仅是计时器,它是一个由需要实时通信、协调和相互响应的互联制作系统组成的网络中的一个节点。当这一刻到来时,API决定了一个工具能否参与这个网络,还是仍然是一个孤立的岛屿。 Timers Studio公开了53个按照OpenAPI 3.1规范文档化的REST API端点。这不是对集成的象征性姿态,而是一个全面的控制面,将系统中每个有意义的参数和操作暴露给编程访问。 API围绕四个安全范围组织。READ提供所有监控和状态检索端点的访问。TRANSPORT添加计时器播放控制。MUTATION添加数据修改能力。ADMIN提供完整访问权限。每个API密钥在创建时被分配特定的范围。 实时监控能力建立在Server-Sent Events之上。客户端打开SSE连接,事件发生时即刻接收,而非轮询API检测状态变化。 三个真实自动化场景说明了API的实际价值。第一个使用开源工作流自动化平台n8n,从Google Sheets自动创建每周演出运行表。第二个与vMix集成,实现与计时器运行表同步的自动摄像机切换。第三个使用OBS,在直播叠加层上显示实时计时器值。 API还支持更复杂的自动化模式:基于计时器状态的条件逻辑、定时操作、数据收集和外部触发器。API文档是交互式的,OpenAPI 3.1规范文件可下载,可导入到Postman或Insomnia。 [立即体验] 生成你的第一个API密钥,导播可以通过节目单自动化端点来探索更多可能。交互式文档将帮助你在几分钟内成功发出API调用。[打开工作室] [查看控制台]