API Try-it – Anleitung

Auf jeder Produktseite der API-Referenz wird zusätzlich eine Playground(Try-it)-Konsole bereitgestellt. Sie können die REST-API des Geräts direkt im Browser aufrufen und die Antwort prüfen; darüber hinaus verfügt jede Operation über eine Schaltfläche copy-as-curl (cURL-Befehl kopieren), sodass sich dieselbe Anfrage auch in Umgebungen, in denen ein direkter Aufruf nicht möglich ist, im Terminal ausführen lässt.

1. Geräteadresse eingeben

Geben Sie in der Servervariablen device_ip oben im Playground die IP des Zielgeräts ein (z. B. 192.168.0.30). Da das Gerät die API selbst bereitstellt, muss es sich um eine Adresse handeln, die innerhalb desselben Netzwerks (oder über eine direkte P2P-Verbindung) erreichbar ist.

2. Browser-Unterstützung

Browser	Direkter Aufruf im Browser	Bedingung
Chrome / Edge 142+	Möglich	Nach einmaliger Erteilung der Berechtigung für den lokalen Netzwerkzugriff (LNA) für Ziele mit privater IP
Firefox 149/151+	Weitgehend möglich	Gleiches LNA-Modell, schrittweiser Rollout läuft
Safari	Nicht möglich	Mixed Content im privaten Netz wird blockiert — copy-as-curl verwenden

💡 Hinweis: Diese Dokumentationsseite wird über HTTPS ausgeliefert, die Geräte-API dagegen über HTTP im privaten Netz. Chrome/Edge 142+ nehmen Ziele mit privaten IP-Literalen automatisch von der Mixed-Content-Blockierung aus und zeigen einmalig eine Berechtigungsaufforderung für den lokalen Netzwerkzugriff (LNA) an. Nach dem Zulassen erfolgen die Aufrufe normal.

3. Wenn der direkte Aufruf blockiert ist — copy-as-curl als Fallback

Wenn Sie Safari oder einen älteren Browser verwenden oder wenn Cross-Origin-Anfragen mit Authentifizierung (Basic Auth) durch Browser-Richtlinien blockiert werden, kopieren Sie den cURL-Befehl über die Schaltfläche copy-as-curl der jeweiligen Operation und führen Sie ihn im Terminal aus. Dies funktioniert in allen Browsern und Umgebungen gleichermaßen.

curl -u admin:<password> http://192.168.0.30/setting/status

4. Fehlerbehebung

Wenn die LNA-Aufforderung nicht erscheint oder abgelehnt wurde → Erlauben Sie den lokalen Netzwerkzugriff in den Website-Berechtigungen des Browsers.
Safari blockiert Mixed Content im privaten Netz, daher ist ein direkter Aufruf nicht möglich → Verwenden Sie copy-as-curl.
Geben Sie bei Anfragen, die eine Authentifizierung erfordern, Benutzername und Passwort ein. Das Standardkonto des Geräts muss beim ersten Zugriff unbedingt geändert werden.