List of network devices

Network devices can be created in two ways:

During auto-provisioning, a request is received at one of the stages to create a network device for the camera
If the camera is manually created, an attempt is made via ONVIF to retrieve the MAC address and serial number. If the data is successfully retrieved, a network device is created

This information is not related to DHCP. Network devices are an internal entity of the VMS

GET /api/admin/v1/network-devices

Method parameters

int per_page, the number of items per pagination page. Default is 25

int page, the page number of pagination

string ip, the page number of pagination

string mac, MAC address

bool has_not_cam, devices without cameras

200 OK

Successful response

JSON

{
    "data": [
        {
            "uuid": "ca237cd8-6a0a-40f9-8791-9c739d5d50d3",
            "ip": "192.168.204.18",
            "serial_number": "DS-2CD2143G0-IS20201222AAWRF25858401",
            "mac": "EC:C8:9C:72:49:ED",
            "created_at": "2022-04-05 12:41:04"
        },
        {
            "uuid": "8f574385-8683-42c0-abe0-c1db3e2df2e9",
            "ip": "10.208.9.30",
            "serial_number": "123456789",
            "mac": "00:1C:27:15:99:DA",
            "created_at": "2022-02-18 15:07:03"
        },
        {
            "uuid": "39656a41-8039-448c-89c1-dbf9e42c336d",
            "ip": "192.168.7.113",
            "serial_number": "DS-2CD2020F-I20150815AAWR536062563",
            "mac": "C4:2F:90:B0:AB:72",
            "created_at": "2022-01-28 01:54:14"
        },
        {
            "uuid": "d3940908-89ef-45c7-8aec-4963a01c3f86",
            "ip": "192.168.7.23",
            "serial_number": "000B8260C699",
            "mac": "00:0B:82:60:C6:99",
            "created_at": "2022-01-27 19:53:15"
        },
        {
            "uuid": "f31c8892-6859-45ad-8a07-3fa5fc08387d",
            "ip": "192.168.7.35",
            "serial_number": "000B8260C66B",
            "mac": "00:0B:82:60:C6:6B",
            "created_at": "2022-01-27 19:49:18"
        },
        {
            "uuid": "3d0b6ec3-bf28-4ed3-95d0-370ca3d935bf",
            "ip": "192.168.7.22",
            "serial_number": "000B8260C6FD",
            "mac": "00:0B:82:60:C6:FD",
            "created_at": "2022-01-27 19:47:16"
        }
    ],
    "links": {
        "first": "https://vms.local/api/admin/v1/network-devices?per_page=25&amp;mac=2&amp;has_not_cam=0&amp;page=1",
        "last": "https://vms.local/api/admin/v1/network-devices?per_page=25&amp;mac=2&amp;has_not_cam=0&amp;page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "pagination.previous",
                "active": false
            },
            {
                "url": "https://vms.local/api/admin/v1/network-devices?per_page=25&amp;mac=2&amp;has_not_cam=0&amp;page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "pagination.next",
                "active": false
            }
        ],
        "path": "https://vms.local/api/admin/v1/network-devices",
        "per_page": 25,
        "to": 6,
        "total": 6
    }
}

401 Unauthorized

Authorization token is not provided or is invalid. Obtaining a token

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/admin/v1/network-devices' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "per_page": 0,
    "page": 0,
    "ip": "string",
    "mac": "string",
    "has_not_cam": true
}'

PHP

$data = array (
  'per_page' => 0,
  'page' => 0,
  'ip' => 'string',
  'mac' => 'string',
  'has_not_cam' => true,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'GET',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/admin/v1/network-devices', false, $context);