get-dev接口
获取指定设备的详细信息，此设备必须是通过云平台审核的。
接口原型
| 协议 |
HTTP/HTTPS GET |
| URL |
ip[:port]/sc_cloud/scapi/get-dev?sn=xxx |
| 数据格式 |
响应消息：Content-Type: application/json |
请求URL参数
请求Cookies
| 名称 |
描述 |
| mwcloud-sid |
用于标识当前登录的字符串 |
| mwcloud-uid |
当前登录用户名 |
请求示例
GET /sc_cloud/scapi/get-dev?sn=A302190930002 HTTP/1.1
Accept: application/json, text/plain, */*
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
响应参数
| 参数 |
描述 |
| Content-Type |
取值为：'application/json; charset=UTF-8' |
Response Body
| 参数 |
描述 |
| result |
返回码。 |
| dev |
指定设备的详细信息。 |
dev
| 参数 |
描述 |
| catalog-id |
设备分组ID。 |
| sn |
序列号。 |
| module |
产品族编号。 |
| dev-warning |
取值大于0，表示异常设备。 dev-warning取值与异常设备状态掩码中的所有掩码做逻辑与计算，可能有多个异常。
例如：(dev-warning & 0x01)=== 0x01，表示此设备无信号。 |
| is-everyone |
是否所有用户可见。0：否，1：是。 |
| users |
is-everyone取值为0时有效，可见用户集合。 |
| apply-date |
申请时间。 |
| online-date |
设备在线时间。大于0：设备在线，小于等于0：设备离线。 |
| is-upload-file |
是否在上传固件。1：正在上传固件到设备上。
使用参见：设备升级流程。 |
| upload-file-pos |
固件上传进度百分比。 |
| status |
设备的基本信息。 |
status
| 参数 |
描述 |
| name |
设备名称。 |
| product-id |
设备产品编号。 |
| module-name |
设备产品型号。 |
| hardware-ver |
硬件版本。 |
| firmware-ver |
固件版本。 |
| up-time |
设备上电时间，单位：秒。 |
| cur-status |
设备状态掩码，不同设备不同处理。 |
| eth |
以太网IP。 |
| wifi |
WI-FI IP。 |
| rndis |
USB RNDIS IP。 |
| upgrade-ret |
设备安装固件状态码。取值参见：API状态码。
使用参见：设备升级流程。 |
| upgrade-step |
当前升级步骤，一共有4步。 |
| upgrade-percent |
当前设备升级进度。 |
| input |
输入信号格式，包括分辨率、帧率等。 |
| output |
输出信号格式，包括分辨率、帧率等。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 1600
Connection: keep-alive
{
"result": 0,
"dev": {
"catalog-id": 2,
"sn": "A302190930002",
"module": 1,
"dev-status": 2,
"network": "",
"is-upgrade": 0,
"users": [
"Admin"
],
"is-everyone": 0,
"apply-date": 1634088523,
"online-date": 1635413950,
"offline-date": 0,
"is-upload-file": 0,
"upload-file-pos": 100,
"dev-warning": 1,
"sid": "245afe8cc4362ad0355f672433ff8608",
"cpu": [],
"mem": [],
"net": [],
"net2": [],
"net3": [],
"status": {
"name": "Ultra Stream A302190930002",
"product-id": 770,
"module-name": "Ultra Stream SDI",
"hardware-ver": "A",
"firmware-ver": "1.5.178",
"conn-ip": "",
"up-time": 104370,
"eth": "",
"sd-total": 32217448448,
"cur-status": 0,
"wifi": "10.10.3.34",
"input": "No Signal",
"output": "",
"usb-total": 0,
"usb-free": 0,
"usb-used": 0,
"usb-status": 0,
"usb-usage": 0,
"sd-free": 18495471616,
"sd-used": 12648235008,
"sd-status": 1,
"sd-usage": 40,
"rec-codec": "1280x720, 59.94, 2048 Kbps",
"rec-sec": 0,
"rec-kbps": 0,
"live-codec": "1280x720, 30.00, 1024 Kbps",
"live-sec": 0,
"live-kbps": 0,
"ndi-connected": false,
"ndi-url": "",
"ndi-enabled": false,
"rndis": "",
"ndi-name": "",
"ndi-video-width": 0,
"ndi-video-height": 0,
"ndi-video-scan": "",
"ndi-video-field-rate": 0,
"ndi-audio-sample-rate": 0,
"ndi-audio-channels": 0,
"ndi-audio-bit-count": 0,
"upgrade-ret": 27,
"upgrade-step": 0,
"upgrade-percent": 0,
"usb-option": 0,
"sd-option": 1,
"CPUStatus": 18,
"NetStatus": 0,
"MemStatus": 44,
"Net2Status": 2328,
"Net3Status": 0
}
}
}