Allgemein
Das Robonect H30x Modul bietet die folgenden Schnittstellen zur Integration in eigene Anwendungen an.
- URL: http://192.168.2.1/xml?cmd=...
Rückgabewert ist XML-Formatiert. Die Daten bedinden sich innerhalb eines <robonect>...</robonect> Tags. - URL: http://192.168.2.1/json?cmd=...
Rückgabewert ist JSON-Formatiert
Der unterstützte Befehlssatz ist bei beiden Schnittstellen identisch. Lediglich die Formatierung der Antwort unterscheiden sich.
Authentifizierung
Sofern Sie Benutzername und Passwort vergeben haben, müssen Sie sich beim nutzen dieser API ebenfalls authentifizieren. Dies kann auf zwei unterschiedliche Arten erfolgen:
- HTTP-Authentifizierung
- Als zusätzliche Parameter im Query String (z.B. http://192.168.2.1?user=...&pass=...&cmd=...)
Jede Anfrage wird mindestens mit dem successful Wert quittiert. Dieser boolesche Wert kann true oder false sein. Im Fehlerfall werden noch die zusätzlichen Werte error_code und error_message übertragen.
Die möglichen Fehlercodes sind hier beschrieben.