WEBSOCKET 和 JSON-RPC API

如果你想和streamd服务器直接交流，那可以使用WebSocket API或JSON-RPC API。两种API都使用相同的命令列表，每个命令中参数几乎完全相同。与Radar-REST API 在Websocket API之上提供简化接口而实现更简便的整合不同，这些API提供全功率radar，但要求稍微复杂：

Websocket API 使用在大多数浏览器和Javascript实现可以获得的Websocket协议，从而达到持久的双向交流。请求和回应之间不是1:1的相关性。一些请求推进服务器退还多个异步信息；其他时候，与推进它们的请求相比，回应可能以不同的顺序到达。streamd服务器可以配置接受安全的（wss://）、不安全的（ws://）Websocket连接，或同时接受两个。

JSON-RPC API依赖通过HTTP或HTTPs的相同请求-回应交流。（streamd服务器可以设置接受HTTP、HTTPS，或同时接受两个。）对于推进多个回应的命令，你可以提供一个回调URL。

streamd程序也可以被用作快速命令行客户端，向正在运行的streamd服务器发送JSON-RPC请求。这是为管理目的而设计，不是受支持的API。

一般来说，我们推荐使用WebSocket，因为WebSocket的推动范例有较少的延迟和网络开销。JSON-RPC处理每个个体信息时必须打开和关闭HTTP连接。WebSocket也更靠谱，你不用太担心丢失信息和建立多个连接的问题。然而，这三个都有有效的用例，而且在可预见的未来持续受到支持。