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
}
]
}