# Erste Schritte mit der HTTP-API **URL:** \ **Category:** Administration\ **Tags:** gettingstarted, cgi, http, expert\ **Created:** [August 24, 2018, 8:48am UTC](https://community.mobotix.com/t/erste-schritte-mit-der-http-api/529 "2018-08-24T08:48:05Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![Mx-JasminU](https://avatars.discourse-cdn.com/v4/letter/m/7993a0/32.png) [@Mx-JasminU](https://community.mobotix.com/u/Mx-JasminU)\ **Post date:** [August 24, 2018, 8:48am UTC](https://community.mobotix.com/t/erste-schritte-mit-der-http-api/529/1 "2018-08-24T08:48:05Z")
# Einführung Eine Anwendungsprogrammierschnittstelle (API) ist eine Gruppe von Programmieranweisungen und Standards zum Zugreifen auf eine Softwareanwendung oder ein Webwerkzeug. Eine API ist eine Software-zu-Software-Schnittstelle, keine Benutzerschnittstelle. Mit APIs kommunizieren Anwendungen ohne Benutzerkenntnisse oder Interventionen. # MOBOTIX HTTP API Die HTTP-API (Application Programming Interface) ist eine Software-Schnittstelle zur Kamera und ermöglicht die einfache Integration der Kamera in ein zentrales Managementsystem. Die Schnittstelle besteht aus mehreren CGI-Skripten, die über HTTP-Befehle mit Parametern und Werten aufgerufen werden können. Mit diesen Skripten können Sie die Einstellungen der Dialoge im Setup-Menü ändern und bestimmte Kamerafunktionen ausführen. # Häufigste Verwendung - Änderung der Konfiguration: Aufzeichnungen, Ereignisse, Aktionen usw. - Änderung der Bildeinstellungen: Belichtung, Bildqualität, Bildauflösung usw. - Statusanforderungen - Auslösen von Aktionen # API-HTTP-Anfragebeschreibung Eine normale HTTP-Anfrage vom Browser sieht folgendermaßen aus: `http://<ip_address_for_the_camera>/control/control?list&section=recording` Welche wiefolgt aufgeteilt werden können: - **Protokoll:** http: // - **Ziel:** \ - **CGI-Aufruf:** /control /control - **Parameter:** list§ion=recording Somit hat eine wohlgeformte Anfrage hat die Form: `Protokoll + Ziel + CGI-Aufruf + Parameter` Die vorherige Anfrage wird die folgende HTTP-Antwort liefern: ![imagen](https://canada1.discourse-cdn.com/flex030/uploads/mobotix/original/1X/954f2c4ce4b35f9cc9d71afed3cda5bcddf1c64c.png) Hier werden die aktuellen Konfigurationsoptionen für Aufzeichnungen angezeigt. # CGI-Anrufe ### /control/control Mit dem HTTP-Befehl `http://<ip_address_for_the_camera>/control/control` können Sie die Einstellungen des Setup-Menüs ändern. Geben Sie `http://<ip_address_for_the_camera>/control/control?list` ein, um die verschiedenen verfügbaren Abschnitte anzuzeigen. ![imagen](https://canada1.discourse-cdn.com/flex030/uploads/mobotix/original/1X/dad4463ee31309240b4c7dd480cec2d76045519e.png) ### /admin/control Mit dem HTTP-Befehl `http:///admin/control` können Sie die Einstellungen des Admin Menüs ändern. Geben Sie `http://<ip_address_for_the_camera>/admin/control?list` ein, um die verschiedenen verfügbaren Abschnitte anzuzeigen. ![imagen](https://canada1.discourse-cdn.com/flex030/uploads/mobotix/original/1X/aab113b9f2a82042f7990cfe146dfa3999b0f705.png) ### /control/rcontrol und /admin/rcontrol Mit dem HTTP-Befehl `http://<ip_address_for_the_camera>/control/rcontrol?list` Können Sie sich bestimmte **Aktionen** anzeigen lassen, die ausgeführt werden können `http://<ip_address_for_the_camera>/control/rcontrol?action=sound&soundfile=Alarm` Durch Aufruf dieser HTTP-Anfrage spielt die Kamera eine Audiodatei ab. Einige dieser Funktionen können nur als Admin-Benutzer aufgerufen werden ![imagen](https://canada1.discourse-cdn.com/flex030/uploads/mobotix/optimized/1X/bb61cf81038978b4ca0f6f47e4d7877fdbd40e2d_2_690x46.png) In diesem Fall wäre die HTTP-Anfrage: `http://<ip_address_for_the_camera>/admin/rcontrol?action=reboot` # vPTZ Einstellungen Als Konsequenz der Integration der Q-Kameramodelle bieten die Kameras vPTZ-Funktionen (virtuelles Schwenken / Neigen / Zoomen) auch in der HTTP-API. Die entsprechenden Features wurden in speziellen Hilfe-Dialogen dokumentiert, die über die entsprechenden Links geöffnet werden können: ### click.cgi Diese Schnittstelle bietet eingeschränkten Zugriff auf einfache vPTZ-Funktionen. `http://<ip_address_for_the_camera>/control/click.cgi?help` ### rotor.cgi Diese Schnittstelle bietet vollen Zugriff auf alle vPTZ-Funktionen `http://<ip_address_for_the_camera>/control/rotorcgi?help` ### control?list§ion=vptzcontrol Die Steuerung bietet auch Zugriff auf einige vPTZ-Funktionen, wie im vptzcontrol-Abschnitt beschrieben. `http://<ip_address_for_the_camera>/control/control?list&section=vptzcontrol` # Bild CGI-Anrufe Zusätzlich gibt es eine Reihe von CGI-Aufrufen, um Live-Bilder, Videostreams und Aufnahmen der Kamera direkt vom integrierten Webserver abzurufen. ### /record/current.jpg `http://<ip_address_for_the_camera>/record/current.jpg` - Ruft ein Kamerabild gemäß den aktuellen Bildeinstellungen ab - Sie können keine zusätzlichen Parameter angeben ### /cgi-bin/image.jpg `http://<ip_address_for_the_camera>/cgi-bin/image.jpg` - Ruft ein Kamerabild unter Verwendung zusätzlicher Bildparameter ab. - Die gespeicherte Konfiguration wird nicht geändert und hat keine Auswirkungen auf das Livebild. `http://<ip_address_for_the_camera>/cgi-bin/image.jpg?camera=right&size=320x240&quality=60` - **camera=right** ist das richtige Objektiv auf Dual-Kameras - **size=320x240** ist die Auflösung des Bildes - **quality=60** ist der Qualitätsprozentsatz Durch das Anhängen von ?help am Ende des Befehls wird die entsprechende Hilfeseite mit allen verfügbaren Optionen angezeigt: `http://<ip_address_for_the_camera>/cgi-bin/image.jpg?help` ### /cgi-bin/faststream.jpg or /control/faststream.jpg Ruft den Live-Stream mit zusätzlichen Bildparametern von der Kamera ab. - /cgi-bin/faststream.jpg mit Gastzugang - /control/faststream.jpg mit Benutzerzugriff ### /control/event.jpg Bietet Zugriff auf die Ereignisse der Kamera und ermöglicht das Hinzufügen zusätzlicher Parameter. `http://<ip_address_for_the_camera>/cgi-bin/event.jpg` Die folgende Anfrage liefert beispielsweise das letzte Ereignisbild der Kamera: `http://<ip_address_for_the_camera>/control/event.jpg?sequence=head` Durch das Anhängen von ?help am Ende des Befehls wird die entsprechende Hilfeseite mit allen verfügbaren Optionen angezeigt: `http://<ip_address_for_the_camera>/control/event.jpg?help` # Zusätzliche Hilfe Die Hilfeseiten auf der Kamera bieten einen Überblick über die API-Befehle und zusätzliche Beispiele. Die Hilfeseiten können über das ? Symbol in der oberen rechten Ecke des Kamera-Web-Interface oder über die URL: > http://\/help/help aufgerufen werden. Am unteren Rand der MOBOTIX-Online-Hilfe befindet sich der Bereich Fernsteuerung ![imagen](https://canada1.discourse-cdn.com/flex030/uploads/mobotix/original/1X/f7c12a77bb780b5e0f646031449a38f70bbbdb9a.png)