Wie genau kann ich die API ansprechen?
Wir haben die Schnittstelle so entwickelt, dass Sie sich selber dokumentiert,
damit wir uns die Möglichkeit offen halten, weitere Kundenwünsche schnell und
unkompliziert hinzuzufügen, ohne dem Kunden immer eine neue Doku zukommen
lassen zu müssen.
Bitte rufen Sie folgende Url auf:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]
um noch ein paar Beispiele zu liefern:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]
liefert die Möglichen Funktionen. Also z.B 'setNotifcation', 'setActive', 'help'.
Jetzt können Sie z.B. folgendes aufrufen:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=help
Dieser Aufruf sagt Ihnen jedoch, dass der Parameter function_name benötigt wird.
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=help&function_name=setNotifcation
Wenn Sie dies nun aufrufen erhalten Sie die Info, dass diese Funktion folgende Parameter benötigt: 'server_id', 'contact_type', 'contacts', 'handshake'
Bei 'server_id' handelt es sich um die Server ID, die Sie in der Methode
'listAccountDetails' auslesen können. "
Also machen wir einfach mal den Aufruf:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=setNotifcation&server_id=1234
Die Ausgabe sagt, dass contact_type fehlt, also probieren wir:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=setNotifcation&server_id=1234&contact_type=
Die Schnittstelle meldet: Invalid value for 'contact_type'. Valid values are 'email','mobile','call','messenger','twitter' '' given.
Also z.B.:
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=setNotifcation&server_id=1234&contact_type=twitter
Nun Fehlt noch "contacts" und "handshake"...
http://api.livewatch.de/remote/manage?login=[ihr Login]&api_key=[ihr API key]&method=setNotifcation&server_id=1234&contact_type=twitter& handshake=meinhandshakewert&contacts[]=account1&contacts[]=account2
"handshake" ist einfach nur ein Parameter, den Sie nach dem Aufruf wieder zurückbekommen.
Die Funktion meldet nun OK - jedoch ist die server_id noch auf eine von Ihnen korrekte ID anzupassen.
