---
title: "Kamera-Steuerungen"
source: /de/gcxone/api/camera-controls
locale: de
updated: 2026-09-04
---
Operationen an Kamera-Steuerungsressourcen. 6 Endpunkte, jeweils relativ zu `https://api.nxgen.cloud/api/v1` und authentifiziert, wie unter beschrieben [Authentifizierung](/gcxone/api/authentication).

## GET /cameraControls/clipInfo

Clip-Info für Zeitleiste abrufen

### Parameter

| Name | In | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- | --- |
| id | Abfrage | Zeichenkette | ja | Kamera‑Kennung |
| startDate | Abfrage | Zeichenkette | ja | Epochenzeit |
| endDate | Abfrage | Zeichenkette | ja | Epochenzeit |

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg |  |
| 204 | Kein Inhalt |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |

## GET /cameraControls/getSnapshot

Snapshot-Details für Sensor abrufen

### Parameter

| Name | In | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- | --- |
| sensorUniqueId | query | string | ja | Sensor eindeutige ID |
| deviceUniqueId | query | string | ja | Gerät eindeutige ID |
| dateTime | query | string | nein | Datum Uhrzeit |

### Antworten

| Status | Beschreibung | Body |
| --- | --- | --- |
| 200 | Erfolg |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |

## GET /cameraControls/getStream

Streaming-Details des Sensors abrufen

### Parameter

| Name | In | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- | --- |
| sensorId | Abfrage | String | ja | Sensor-ID |
| channelId | Abfrage | String | nein | Kanal-ID |
| Startzeit | Abfrage | String | nein | Startzeit des Streams |
| endTime | Abfrage | String | nein | Endzeit des Streams |

### Antworten

| Status | Beschreibung | Body |
| --- | --- | --- |
| 200 | Erfolg |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |

## PUT /cameraControls/isolate

Kamera isolieren

### Anfragekörper

Isolieren

```json
[
  {
    "id": "sensor uniqueId",
    "isIsolate": "boolean",
    "startTime": "Epoch time in milliseconds",
    "duration": "Time in minutes"
  }
]
```

### Antworten

| Status | Beschreibung | Body |
| --- | --- | --- |
| 200 | Erfolg |  |
| 204 | Kein Inhalt |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |

## GET /cameraControls/playAudio?deviceId={deviceId}&language={language}&audioFile={audioFile}

Audio-Datei abspielen

### Parameter

| Name | In | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- | --- |
| deviceId | Abfrage | Zeichenkette | ja |  |
| language | Abfrage | Zeichenkette | ja |  |
| audioFile | Abfrage | Zeichenkette | ja |  |

### Antworten

| Status | Beschreibung | Body |
| --- | --- | --- |
| 200 | Erfolg |  |
| 204 | Kein Inhalt |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |

## GET /cameraControls/presetPTZ

PTZ / Preset ausführen

### Parameter

| Name | In | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- | --- |
| id | Abfrage | Zeichenkette | ja |  |
| Aktion | Abfrage | "R" \| "R\_STOP" \| "L" \| "L\_STOP" \| "U" \| "U\_STOP" \| "D" \| "D\_STOP" \| "Z+" \| "Z+\_STOP" \| "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" | ja | Wählen Sie einen Wert von 1 bis 10 für Preset, alle anderen für PTZ |
| commandType | Abfrage | "ptz" \| "preset" | ja |  |
| webSocketPort | Abfrage | Zeichenkette | nein | erforderlich für Heitel Gerätetyp |
| momentSpeed | Abfrage | Zeichenkette | nein | PTZ-Geschwindigkeit |

### Antworten

| Status | Beschreibung | Body |
| --- | --- | --- |
| 200 | Erfolg |  |
| 204 | Kein Inhalt |  |
| 401 | Nicht autorisiert |  |
| 403 | Verboten |  |
| 404 | Nicht gefunden |  |