针对 Pro Convert ，我们开放了丰富的 API，方便开发人员与设备交互，如获取设备的基本信息（设备名称、固件版本等），修改设备配置，更新固件等。这些 API 基于 HTTP 协议，是一种轻量级、无连接状态的接口，响应数据为 JSON 格式。通过本文档，您可以更详细地了解每个 API 的功能和请求方式。

本文档中的 API 可适用于以下产品：
Pro Convert HDMI 4K Plus
Pro Convert HDMI Plus
Pro Convert HDMI TX
Pro Convert 12G SDI 4K Plus
Pro Convert SDI 4K Plus
Pro Convert SDI Plus
Pro Convert SDI TX 


“NDI” 是 NewTek, Inc. 在美国和其他国家的注册商标。 

本文通过 Node.js 环境下的两个实例介绍如何调用 Pro Convert API。

DEMO 下载链接：pro-convert-api-demo-nodejs.zip

DEMO 目录结构：
pro-convert-api-demo-nodejs
|
|-- httpUtils.js // 基于 nodejs 的 HTTP 模块封装了 get 方法和 upload 方法
|-- DEMO_EDID.bin // upload.js 调用 upload-edid 接口时默认的上传文件，使用时请替换为自己设备的 EDID 文件
|-- get.js // 通过 GET 方式调用接口获取数据
|-- upload.js // 通过 POST 方式实现文件上传


环境准备
•操作系统：支持 macOS，Linux，Windows
•运行环境：建议选择 LTS 版本，最低要求 8.x

运行方式

1.在终端控制台进入 DEMO 目录
cd pro-convert-api-demo-nodejs


2.运行 get.js
node get


3.运行 upload.js 

环境准备
•操作系统：支持 Windows、macOS、Linux

源码编译
•开发者自己准备相应平台(Windows/macOS/Linux/...) 的"curl sdk"
•DEMO 下载链接：pro-convert-api-demo-c.zip
•编译 "pro_convert_curl.c"，链接到"libcurl"
•生成可执行性文件 "pro_convert_curl"

运行方式
•在终端控制台进入 bin 目录、执行相应平台的 pro_convert_curl。
cd pro-convert-api-demo-c/bin/linux
./pro_convert_curl

•输出结果

***** 1. login *****
login response data:
{
"status": 0
}

***** 2. get caps *****
get caps response data:
{
"status": 0,
"max-input-width": 4096,
"max-input-height": 2160,
"max-output-width": 4096,
"max-output-height": 2160,
"has-input": true,
"has-output": true,
"has-loop-through": true,
"has-fan": true,
"has-input-edid": true,
"has-output-edid": true,
"has-sdcard": true,
"has-ptz": true
}

***** 3. upload EDID *****
upload EDID response data:
{
"status": 0,
"data": "AP///////wA09wEAAQAAAAEaAQOAAAB4Au6Vo1RMmSYPUFT//4AxQEVAYUBxQIGA0QDhwAEACOgAMPJwWoCwWIoAUB10AAAeAjqAGHE4LUBYLEUAUB10AAAeAAAA/QAPlg+HPAAAAAAAAAAAAAAA/ABNQUdFV0VMTAogICAgAWYCA1HxV2EQHwQTBRQgISJdXl9gZWZiY2QHFgMSMgl/BxUHUD0GwFcGAF9/AWd/AINPAADiAA9uAwwAEAC4eCEQgAECAwRn2F3EAXiAA+MPAeABHYAYcRwWIFgsJQBAhGMAAJ5mIVaqUQAeMEaPMwBQHXQAAB4AAAAAAAAAAAAAzw=="
}