M2M Web Service API

M2M Web Service API, was ist das eigentlich?

Die Telekom Web Service API Schnittstelle bietet in erster Linie Unternehmen mit eigener Entwicklungsabteilung die Möglichkeit, Ihre M2M SIM Karten über eine gesicherte XML Schnittstelle (B2B Gateway) zu monitoren und zu administrieren. Bei der Web Service API steht die Geschwindigkeit zur Bereitstellung der angeforderten Informationen und Aktionen im Vordergrund.

Vorteile der Web Service Schnittstelle sind die "Just in Time" Verarbeitung der Request/Response Kommunikation, sowie die unabhängige Bereitstellung von asynchronen Informationen über zwei zusätzl. Interfaces (z.B. SIM Aktivierungs Ergebnisse).

Und wie funktioniert das genau?

Wenn Sie Beispielsweise ein Reseller von M2M Services oder ggf. ein Service Provider sind und Sie möchten Ihren Kunden eine eigene graphische Oberfläche zur Verfügung stellen, dann ist die Web Service API genau das richtige für Sie. Zwei agile B2B Interfaces für synchrone sowie zwei Interfaces für asynchrone Kommunikation, bieten unabhängige und schnelle Verarbeitung Ihrer angeforderten Informationen u. Aktionen. Somit können Sie Ihren Kunden, die zu Ihrem Use Case passenden Infos aus dem Wirknetz der Deutschen Telekom in Echtzeit übermitteln. Web Service Security (WSS) und Ihr Serviceportal benutzerbezogener API-Key sorgen für die Integrität und die Sicherheit Ihrer übertragenen Informationen.

Weiterführende Links

Möglicher Web Service API Use Case

Lassen Sie uns einmal annehmen, das Ihre Firma XY im Alarmanlagen Business unterwegs ist. Einer der Schlüssel Funktionen für Ihre Kunden ist ein weltweiter Internet Zugriff auf eine grafische Oberfläche (GUI), zur Ortung der eingesetzten Alarm Module im Feld. Zusätzlich bietet Ihre GUI eine Funktion zur Ermittlung der aktuellen Kosten für aufgebaute Datenverbindungen zum Alarm Modul im jeweiligen Monat.

Aufgabenstellung und mögl. Lösung

Wenn Ihr Kunde in seiner personalisierten GUI (angemeldet als Kunde xy) auf den Button "Datenverbrauch ermitteln" drückt, muss Ihre Applikation in der Lage sein, das Datenvolumen rechnerisch mit dem Kostenschlüssel Ihrer verschiedenen Reseller Tarife zu berechnen und in der GUI den aktuellen Preis auszugeben. Normalerweise benötigen Sie hierfür einen eigenen Radius Server mit eigener IP-VPN Anbindung (mögl. Redundant mit Accounting Verarbeitung). Eine kostengünstigere Alternative kann folgendermaßen aussehen.

Der Client PC Ihres Kunden (Abb. 1) fordert über seine GUI den aktuellen Datenverbrauch per form.submit(); an. Ihr App Server (Abb. 2) feuert daraufhin den Web Service Request SIMUsageGet(); über das M2MMon Interface in Richtung Telekom ab (Abb. 3). Telekom B2B Gateway prüft die Signatur und den Timestamp des Request's sowie den Client Token (API-Key). Die weitere Telekom interne Kommunikation ist in Magenta Pfeilen von Abb. 4 bis 8 dargestellt. Zusammengefasst wird Telekom intern kurz geprüft, ob die SIM Karte gerade online ist. Wenn ja, wird eine Abfrage in Richtung Telekom GGSN gestartet und der Live-Verbrauch (Online-Zeit, verbrauchtes Volumen, Anz. Sessions im aktuellen Monat) als Response zurückgegeben (Abb. 8). Wenn die Karte offline ist, wird der Response Wert aus der M2M DB entnommen. Ihre Applikation parsed die Response entsprechend (Abb. 9) und gibt in der GUI die aktuellen Kosten x für Ihren Kunden an (Abb. 10).

In diesem Web Service Modell wird die End2End Request/Response Kommunikation veranschaulicht. Sie wird vom Endkunden getriggert und über den App-Server Ihrer Firma per SOAP-XML Request (signiert mit WSS) an die Telekom Infrastruktur weitergeleitet. Über die aufgebaute und weiterhin geöffnete Socket Verbindung (M2MMon Interface) wird nach x Millisekunden die Antwort von M2M als Response an Ihren Web Service gesendet. Ihre Applikation parsed die XML-Information, verarbeitet diese und schmeisst dem Kunden seine angeforderten Kosten aus.