M2M File API

M2M File API, was ist das eigentlich?

Die Telekom M2M File API Schnittstelle bietet in erster Linie großen Unternehmen die Möglichkeit, ihre M2M SIM Karten über eine gesicherte XML Schnittstelle (Telekom ebXML Gateway) massenhaft zu administrieren. Das können beispielsweise SIM Karten Massenaktivierungen oder andere definierte XML Aktionen sein, welche über die graphische Oberfläche des M2M Serviceportals nur schwer, oder gar nicht durchführbar sind.

Bisher noch nicht vollständig implementiert aber demnächst verfügbar, ist der automatisierte Rechnungsversand/Push über File API zum Zeitpunkt der periodischen Rechnungsstellung.

Und wie funktioniert das genau?

Wenn Sie eine Applikation entwickelt haben, die in der Lage ist Informationen aus einer Datenquelle zu parsen um daraus SOAP-XML Nachrichten automatisiert zu erzeugen, dann geht der Transport dieser Nachrichten fast von selbst. Die Telekom bietet Ihren M2M Kunden mit gebuchter API die einfach zu implementierende Software Lösung vom externen Partner Axway an. Der sogenannte Axway Activator kümmert sich für Sie um die Verschlüsselung, Komprimierung und um den Transport der XML Dateien (ebXML über HTTPS). Weiterführende Dokumente zur Software Komponente Axway Activator, sowie die Systemvoraussetzungen zur Verbindung mit dem ebXML Gateway finden Sie rechts verlinkt.

Weiterführende Links:

Möglicher File API Use Case

Wir sind wieder mit Ihrer fiktiven Alarmanlagen Firma XY unterwegs. Ihre Firma muss wöchentlich ca. 6.000 GPS Alarm Module ausliefern, damit der aktuellen Kunden Nachfrage entsprochen werden kann. Lassen Sie uns weiterhin annehmen, das Ihre Alarm-Module von einem externen Hersteller gebaut, sowie mit M2M SIM Karten/Chips in der Fertigung bestückt werden. Jeder fertig produzierte Alarm-Melder hat also eine eindeutige Geräte-ID (IMEI), sowie eine verbaute eindeutige SIM-ID (ICCID).

Aufgabenstellung und mögl. Lösung

Um Fehler in der Protokollierung der Bauphase zu vermeiden (welche ICCID gehört zu welcher IMEI), und um zu jeder Zeit selbst die volle Kontrolle der verbauten SIMs zu den Geräten zu haben, (Ihre Applikation muss am Ende mit den richtigen Alarm Modulen/SIM Karten kommunizieren, siehe Abb. 1 zu 3) kann eine Lösung (von vielen), folgendermaßen aussehen.

Sie übernehmen die Massenaktivierungen der auszuliefernden ICCIDs an den externen Hersteller via File API selbst (Abb. 1 zu 2) und setzen das XML Element "TestTariffPlan" der XML-Prozedur SIMActivation auf den Wert "true". Der Test Tarif lässt die SIM Karte quasi "schlummern" und verursacht keine Kosten. Erst wenn der externe Hersteller auf der Produktionsstraße den mobilen Daten Verbindungstest macht, oder wenn das Modul am finalen Einsatzort mobile Datenverbindungen aufbaut, beginnt die Vertragslaufzeit der SIM. Die IMEI wird bei initialer Verbindung autom. in die M2M Serviceportal 2.0 Datenbank (M2M CRM) eingetragen. Sie machen einen Datenabzug aus CRM im csv Format und sind jederzeit auf dem laufenden über Ihre Geräte und SIMs im Feld. Die Schnittstelle von Ihrem CMS zur File API (Axway Activator) kann JMS, file system, web service, ftp oder MQSeries (WebSphere MQ) sein.

Ihre Applikation (Abb. 1) ist das Herzstück dieses Daten Kommunikationsmodells. Ihre Applikation kann jederzeit die gelieferten M2M SIM Karten über das ebXML Gateway administrieren (Abb. 1 zu 2) und z.B. Massenaktivierungen auf den Punkt kontrolliert durchführen. Dies geschieht indem Sie gezielt die optionalen XML Elemente "ActivationDate" und "TestTariffPlan" der API-Methode SIMActivation einsetzen (Vorausgesetzt natürlich ein entsprechender Test Tarif ist für Ihre M2M Firma im Portal hinterlegt). Nach erfolgter Aktivierung, bzw. Erfüllung einer Bedingung für den zugrunde liegenden Test Tarif (Anz. Verbindungen, Datenvolumen oder Zeit), beginnt die Vertragslaufzeit. Also starten erst dann die monatl. Kosten pro aktivierter SIM. Egal ob Testtarif oder direkt aktivert, Ihre Applikation kann jederzeit mit den Alarm Modulen über das mobile Datennetz kommunizieren (Abb. 1 zu 3).