/api/device/list-with-catalog
Use this interface to obtain device list by groups.
Device group viewing permissions are required.
Prototype
| Protocol |
HTTP/HTTPS GET |
| URL |
ip[:port]/api/device/list-with-catalog |
| Content-Type |
Response: Content-Type: application/json |
Request URL parameters
| Parameter |
Description |
| catalogs |
Optional parameter, comma-separated group IDs. If not specified, all groups will be returned. |
| count |
The maximum number of groups returned |
| start |
The starting index of the returned groups. |
| dev-count |
The maximum number of devices returned. |
| dev-start |
The starting index of the returned devices. |
Sorting rules:
- First, put the online devices at the top.
- Among the online/offline devices, put the devices with the latest application/approval time at the top.
- Among the devices with the same time in the previous rule, put the devices with the smaller serial number at the top.
Request Cookies
| Parameter |
Description |
| mwcloud-sid |
A string that is used to identify current logged-in user. |
| mwcloud-uid |
Current logged-in username. |
Request Example
Request pending device list.
GET /api/device/list-with-catalog?count=10 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
Device Group
| Parameter |
Description |
| id |
Group ID |
| name |
Group name |
| list |
Device list |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"list": [
{
"group-mask": 1,
"id": 30011,
"is-inherit": 0,
"list": [
{
"apply-date": 1685348793609,
"catalog-id": 30011,
"config": null,
"dev-type": 2564,
"dev-warns": 0,
"dir": 512,
"firmware-ver": "1.1.945",
"group-mask": 11,
"hardware-ver": "Z",
"id": 10004,
"is-favorite": 4,
"is-inherit": 0,
"is-upload-file": 0,
"module": 4,
"module-name": "NDI to HDMI",
"name": "Channel-1-OUT",
"online-date": 0,
"owner-o": "testaaa",
"owner-o-d": 100002,
"private-id": 997059098,
"pro-feature": {
"ndi-audio-bit-count": 16,
"ndi-audio-channels": 6,
"ndi-audio-sample-rate": 48000,
"ndi-connected": true,
"ndi-name": "10",
"ndi-video-field-rate": 24.0,
"ndi-video-height": 1080,
"ndi-video-scan": "progressive",
"ndi-video-width": 1920
},
"product-id": 1040,
"push-key": "[MGDEV]-Z410221102011-59264e98",
"reg-state": 101,
"sn": "Z410221102011",
"status": {
"cur-status": 0,
"eth": "10.10.10.193",
"firmware-ver": "1.1.945",
"hardware-ver": "Z",
"is-online": true,
"module-name": "NDI to HDMI",
"name": "Channel-1-OUT",
"rndis": "192.168.66.1",
"up-time": 85641,
"upgrade-status": {
"percent": 0,
"ret": 0,
"step": 0
},
"wifi": ""
},
"type": 513,
"upload-file-pos": 0,
"usr-mask": 18,
"warns": 0
}
],
"name": "dds",
"total": 3,
"usr-mask": 0
},
{
"group-mask": 1,
"id": 30009,
"is-inherit": 1,
"list": [
{
"apply-date": 1687923494490,
"catalog-id": 30009,
"config": null,
"dev-type": 2564,
"dev-warns": 0,
"dir": 512,
"firmware-ver": "1.1.916",
"group-mask": 1,
"hardware-ver": "Z",
"id": 10001,
"is-favorite": 0,
"is-inherit": 1,
"is-upload-file": 0,
"module": 4,
"module-name": "NDI to HDMI",
"name": "Pro Convert",
"online-date": 0,
"owner-o": "Channel-1",
"owner-o-d": 100051,
"private-id": 365273358,
"pro-feature": {
"ndi-audio-bit-count": 0,
"ndi-audio-channels": 0,
"ndi-audio-sample-rate": 0,
"ndi-connected": false,
"ndi-name": "",
"ndi-video-field-rate": 0.0,
"ndi-video-height": 0,
"ndi-video-scan": "",
"ndi-video-width": 0
},
"product-id": 1040,
"push-key": "[MGDEV]-Z410221102013-0f615f1c",
"reg-state": 101,
"sn": "Z410221102013",
"status": {
"cur-status": 0,
"eth": "",
"firmware-ver": "1.1.916",
"hardware-ver": "Z",
"is-online": false,
"module-name": "NDI to HDMI",
"name": "Pro Convert",
"rndis": "",
"up-time": 0,
"upgrade-status": {
"percent": 0,
"ret": 0,
"step": 0
},
"wifi": ""
},
"type": 513,
"upload-file-pos": 0,
"usr-mask": 0,
"warns": 0
}
],
"name": " 6666s ",
"total": 1,
"usr-mask": 0
},
{
"group-mask": 1,
"id": 30008,
"is-inherit": 1,
"list": [
{
"apply-date": 1680746411260,
"catalog-id": 30008,
"config": null,
"dev-type": 3330,
"dev-warns": 0,
"dir": 256,
"firmware-ver": "2.2.81",
"group-mask": 1,
"hardware-ver": "B",
"id": 40,
"is-favorite": 0,
"is-inherit": 1,
"is-upload-file": 0,
"module": 2,
"module-name": "Ultra Encode AIO",
"name": "Ultra Encode B313221116072",
"online-date": 0,
"private-id": 630485446,
"pro-feature": {
"input": ""
},
"product-id": 787,
"push-key": "[MGDEV]-B313221116072-68bc5ca4",
"reg-state": 101,
"sn": "B313221116072",
"status": {
"cur-status": 0,
"eth": "",
"firmware-ver": "2.2.81",
"hardware-ver": "B",
"is-online": false,
"module-name": "Ultra Encode AIO",
"name": "Ultra Encode B313221116072",
"rndis": "",
"up-time": 0,
"upgrade-status": {
"percent": 0,
"ret": 0,
"step": 0
},
"wifi": ""
},
"type": 257,
"upload-file-pos": 0,
"usr-mask": 0,
"warns": 0
}
],
"name": "sss",
"total": 1,
"usr-mask": 0
}
],
"result": 0,
"total": 33
}