Webservice API

Webservice API Grundlagen

Nutzung

Der Zugang zum Webservice hat sich an die Webservice Nutzungsbedingungen zu richten.

Zugriffe werden gelogt und ausgewertet. Um Zugriffe/Bandbreite sowie Serverkapazitäten zu sparen wird empfohlen die Anfragen auf den Webservice soweit es geht zu minimieren. Wir behalten uns das Recht vor Zugänge einzuschränken oder gegebenfalls auch zu sperren.
Zugangsdaten dürfen nicht an Dritte weitergegeben werden oder dargestellt werden.

Datenformat

Der Webservice gibt alles im JSON Format zurück. Wir haben uns gegen XML entschieden da JSON inzwischen genauso weit verbreitet ist und gegenüber XML den Overhead reduziert. Mehr Informationen

Zeichencodierung

Die Ausgabe der Daten des Webservices erfolgt in UFT8

Zugang

Der Zugang zum Webservice erfolgt über eine feste HTTP URL.

http://ws.cloud.topdata.de

Für den Zugang zum Webservice werden Zugangsdaten benötigt die sich wie folgt zusammensetzen.

• User ID (uid)
• Passwort (password)
• Sicherheitscode (security_key)

Die Zugangsdaten müssen bei jedem Aufruf des Webservices mit übergeben werden als HTTP Request.

?uid=%uid%&security_key=%security_key%&password=%password%

Weiter sind folgende HTTP Request Variablen pflicht um eine Antwort vom Webservice zu erhalten

• Webservice_API#API-Version API-Version (version)
• Sprache (language)

?uid=%uid%&security_key=%security_key%&password=%password%&version=100&language=de