get-wait-devs
Use the interface to obtain the cloud-joining applications waiting for approval.
Only available for users with administrative rights.
You can perform the following operations for the applications:
Prototype
Protocol |
HTTP/HTTPS GET |
URL |
ip[:port]/sc_cloud/scapi/get-wait-devs |
Data Format |
Response: Content-Type: application/json |
Request Cookies
Parameter |
Description |
mwcloud-sid |
A string value that is used to uniquely identify user logged-in. |
mwcloud-uid |
Current logged-in username. |
Request Example
GET /sc_cloud/scapi/get-wait-devs HTTP/1.1
Accept: application/json, text/plain, */*
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
Response Parameters
Parameter |
Description |
Content-Type |
Value: 'application/json; charset=UTF-8' |
Response Body
Parameter |
Description |
result |
Result code. The options are as follows:- 0: success.
- Other values. For details about the result codes, please refer to API Status.
|
wait-devs |
List of devices waiting for approval. |
wait-devs
Parameter |
Description |
catalog-id |
Device group ID. |
sn |
Serial number. |
module |
Product family ID. Indicate all hosted devices when it is 0. |
dev-warning |
A number greater than 0 indicates the device has warning(s). The value and mask value in Status Mask of Abnormal Device perform binary logic "and" operator. There might be multiple warnings. For example, if (dev-warning & 0x01)=== 0x01, it means the device has no signal. |
is-everyone |
Whether the device is available for all users. 0: no; 1: yes. |
users |
Operators of the current device when the value of "is-everyone" is 0. |
apply-date |
Time of applying to join the cloud. |
online-date |
Device online state. A number greater than 0 indicates the device is online, otherwise it is offline. |
is-upload-file |
Whether the device is uploading the firmware. 1 indicates it is uploading. Otherwise, it is not. Usage refers to update procedures. |
upload-file-pos |
The upload process in percentage. |
status |
Information of hosted device. |
status
Parameter |
Description |
name |
Device name. |
product-id |
Product model ID in hex. |
module-name |
Product family name. |
hardware-ver |
Product hardware version. |
firmware-ver |
Product firmware version. |
up-time |
Equipment uptime in seconds. |
cur-status |
Current device status mask refers to Status Mask of Abnormal Device. |
eth |
Ethernet IP. |
wifi |
WI-FI IP. |
rndis |
USB RNDIS IP. |
upgrade-ret |
Firmware update status code refers to API Status Code. Update usage refers to update procedures. |
upgrade-step |
Current process of the firmware update procedure, there are 4 steps in total. |
upgrade-percent |
Update process in percentage. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"result": 0,
"wait-devs": [
{
"catalog-id": 0,
"sn": "B401190213050",
"module": 3,
"dev-status": 0,
"network": "",
"is-upgrade": 0,
"users": null,
"is-everyone": 0,
"apply-date": 1635152916,
"online-date": 1635152917,
"offline-date": 0,
"cpu": [],
"mem": [],
"net": [],
"net2": [],
"net3": [],
"sid": "7e0d83332a03a5074268b19286063722",
"status": {
"name": "Pro Convert",
"product-id": 1025,
"module-name": "HDMI 4K Plus",
"hardware-ver": "B",
"firmware-ver": "1.1.207",
"conn-ip": "",
"up-time": 30491,
"eth": "10.10.8.13",
"sd-total": 0,
"cur-status": 0,
"wifi": "",
"input": "1920x1080p60.00",
"output": "unconnected",
"usb-total": 0,
"usb-free": 0,
"usb-used": 0,
"usb-status": 0,
"usb-usage": 0,
"sd-free": 0,
"sd-used": 0,
"sd-status": 0,
"sd-usage": 0,
"rec-codec": "",
"rec-sec": 0,
"rec-kbps": 0,
"live-codec": "",
"live-sec": 0,
"live-kbps": 0,
"ndi-connected": false,
"ndi-url": "",
"ndi-enabled": true,
"rndis": "192.168.65.1",
"ndi-name": "#00 B401190213050",
"ndi-video-width": 1920,
"ndi-video-height": 1080,
"ndi-video-scan": "progressive",
"ndi-video-field-rate": 60,
"ndi-audio-sample-rate": 48000,
"ndi-audio-channels": 1,
"ndi-audio-bit-count": 16,
"upgrade-ret": 108,
"upgrade-step": 0,
"upgrade-percent": 0,
"usb-option": 0,
"sd-option": 0,
"CPUStatus": 15,
"NetStatus": 87701504,
"MemStatus": 59,
"Net2Status": 0,
"Net3Status": 0
},
"is-upload-file": 0,
"upload-file-pos": 0,
"dev-warning": 0
}
]
}