====== SMS Gateway API Version 1 ======
Diese Seite dokumentiert die mittlerweile veraltete, aber immernoch unterstützte API Version 1 des [[:sms|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.

**[[sms:API-Scripte|Liste von Scripten, die die API verwenden]]**


===== Parameter =====

  * **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)


===== Return-Codes =====

  * **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


===== Beispiel =====

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