Cameras

GET /cameras/{cameraId}/io/ports/{portId}

Changed on

Retrieves the device port.

Request

  • Base URL
    https://api.cxxx.eagleeyenetworks.com/api/v3.0
  • URL
    https://api.cxxx.eagleeyenetworks.com/api/v3.0/cameras/{cameraId}/io/ports/{portId}
  • Auth
    HTTP bearer

Query parameters

includestring[]

Response

Successfully fetched.

idstring required

Unique ID for the port.

enabledboolean required

If the port is not enabled, no events will be created, and the icon will not show up in the live stream.

namestring required

Human changeable name of the port, defaults to value of the id field.

type'input' | 'output' required

Denotes whether this is an input or output port.

idleCircuitState'open' | 'closed' required

Indicates the normal, inactive or idle, state of the connected circuit. Possible values:

  • open: means the port is "off" when in idle state (open circuit; has no voltage), and the port state being active means it is turned "on" (circuit is closed; has voltage).
  • closed: means the port is "on" when in idle state (closed circuit; has voltage), and the port state being active means it is turned "off" (open circuit; has no voltage).

Example response

{
  "id": "1",
  "name": "Input 1"
}

Changes

    • breaking

      removed the enum value bssAccountId from the property items/ of the query request parameter include

    • breaking

      removed the enum value ssoOidcIdpConfigUrls from the property items/ of the query request parameter include

    • info

      added the enum value rules to the property items/ of the query request parameter include

    • info

      added the enum value status to the property items/ of the query request parameter include