SMS Gateway API Version 1

Diese Seite dokumentiert die mittlerweile veraltete, aber immernoch unterstützte API Version 1 des SMS Gateways auf tiggersWelt.net.

Die URL zum SMS-Gate via HTTP-API gibt es über den Support bzw. bei Freischaltung eine SMS-Vertrages. Die Funktionsweise der HTTP-API ist relativ simpel und funktioniert im wesentlichen mittels HTTP-GET und HTTP-Return-Codes, die Nutzung ist via HTTP wie auch mit SSL via HTTPS möglich.

Liste von Scripten, die die API verwenden

• to bzw. receiver: Empfänger der SMS - dieser Parameter kann beliebig oft angegeben werden
• from bzw. sender: Benutzerdefinierter Absender der SMS entweder eine Handynummer oder ein bis zu 11 Zeichen langer alphanummerischer Text
• body: SMS-Nachricht
• direct: Sofern erwähnt und ungleich „0“ wird die SMS über Direkteinspeisung versendet
• flash: Sofern erwähnt und ungleich „0“ wird die SMS als Flash-SMS, d.h. sie erscheint direkt im Display des Empfängers, versendet

Die Groß-/Kleinschreibung der Parameter spielt keine Rolle.

Update: Die Parameter sender/from, direct und flash müssen immer vor dem jeweiligen Empfänger (to/receiver) angegeben werden. Weiter können sie bei mehreren Empfängern auch durch bestimmte Reihenfolge individuell konfiguriert werden (vgl. Beispiele)

• 200: SMS wurde erfolgreich an mindestens einen Empfänger gesendet
  

Im zurückgegebenen Dokument steht in der ersten Zeile eine Variable Quantity die die anzahl gesendeter SMS-Seiten angibt, z.B. Quantity: 1

• 204: Die SMS ist leer (Parameter Body fehlt oder enthällt keine Daten)
• 400: Ungenügend Parameter angegeben
• 404: Die SMS hat keine Empfänger (Vorkommen und Validität des Parameters To überprüfen)
• 500: SMS konnte nicht erstellt/versendet werden

https://url-zum-gate?to=0171123456&to=0160123456&body=Hallo+Welt

• Sendet eine SMS via SSL mit dem Text „Hallo Welt“ an die Nummern 0171 123456 und 0160 123456

https://url-zum-gate?direct&to=0171123456&body=Hallo+Welt

• Sendet eine SMS via SSL und Direkteinspeisung mit dem Text „Hallo Welt“ an die Nummer 0171 123456

https://url-zum-gate?to=0160987654&direct&to=0171123456&body=Hallo+Welt

• Sendet eine SMS via SSL mit dem Text „Hallo Welt“ an mit „normalem Routing“ an die Nummer 0160 987654 und mit Direkteinspeisung an die Nummer 0171 123456