1. 主页
  2. 文档
  3. NDI 设备 HTTP API(Version 1.0)

NDI 设备 HTTP API(Version 1.0)

NDI设备HTTP API允许您通过发送HTTP请求到特定的URL来管理和控制千视NDI嵌入式编码器和解码器设备,这包括N3、N4、N30、N40等。当前HTTP API的版本为1.0。

需要说明:目前的HTTP API不是严格意义上的RESTful API,它没有遵循RESTful API的形式化定义规则。因为我们认为对于设备管理和控制来说,RESTful的形式化定义并不能为我们带来特别的好处。无论如何,当前版本的HTTP API足够的简单、易于理解和使用。此外,如果您认为RESTful API对您来说是必要的,请随时告诉我们。

与RESTful API相比,NDI设备HTTP API (Version 1.0)有以下区别:

  1. 我们仅仅使用HTTP GET/POST请求,而不使用PUT/DELETE或其它请求;
  2. 我们只使用JSON格式作为每一个API请求的返回结果(RESTful API大多数情况下也是如此);
  3. 每一个API请求的结果(成功或者失败的标识),我们通过JSON返回结果中的字段来标识,而非像RESTful API那样通过HTTP响应来标识。

要完整地支持本文档所描述的HTTP API,您需要将NDI设备的Firmware升级到主版本号为1.50或更高的版本。之前的版本可能无法完整支持这些API,或存在兼容性问题。

文章

我们要如何帮助您?