SMS HTTP-Gateway: Unterschied zwischen den Versionen
 
(5 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[[category:DCP]][[category:ueberarbeiten]]
[[category:DCP]][[category:fertig]]
==Funktion des SMS-Gateways==
==Funktion des SMS-Gateways==
Das HTTP-Gateway dient dazu, Kurzmitteilungen über Ihre eigenen Skripte zu versenden. Der Versand erfolgt per Aufruf einer URI mit bestimmten Parametern.
Das HTTP-Gateway dient dazu, Kurzmitteilungen über Ihre eigenen Skripte zu versenden. Der Versand erfolgt per Aufruf einer URI mit bestimmten Parametern.
Zeile 6: Zeile 6:


'''URI zum Versenden:'''<br />
'''URI zum Versenden:'''<br />
[http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&amp;password=test123&amp;type=3&amp;empfaenger=01711234567&amp;absender=Ich&amp;content=Dies%20ist%20eine%20Test%20SMS http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&amp;password=test123&amp;type=3&amp;empfaenger=01711234567&amp;absender=Ich&amp;content=Dies ist eine Test SMS]
[http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&amp;password=test123&amp;type=4&amp;empfaenger=01711234567&amp;absender=Ich&amp;content=Dies%20ist%20eine%20Test%20SMS http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&amp;password=test123&amp;type=4&amp;empfaenger=01711234567&amp;absender=Ich&amp;content=Dies ist eine Test SMS]


==Beschreibung der Parameter ==
==Beschreibung der Parameter ==
*'''user''': Dies ist der Name des SMS-Users, den Sie im DCP angelegt haben. In der Beispiel-URI wäre der Username &quot;artfiles&quot;</li>
*'''user''': Dies ist der Name des SMS-Users, den Sie im DCP angelegt haben. In der Beispiel-URI wäre der Username &quot;artfiles&quot;</li>
*'''password''': Hier geben Sie das zu dem SMS-User gehörende Passwort an. In dem Beispiel: &quot;test123&quot;. Das Passwort darf eine max. Länge von 32 Zeichen haben.</li>
*'''password''': Hier geben Sie das zu dem SMS-User gehörende Passwort an. In dem Beispiel: &quot;test123&quot;. Das Passwort darf eine max. Länge von 32 Zeichen haben.</li>
*'''type''': Über diesen Parameter können Sie den Typ der SMS auswählen. Möglich sind Typ 3 und 4.
*'''type''': Über diesen Parameter können Sie den Typ der SMS auswählen.


:* Typ 3: Europäischer SMS-Versand mit Absenderkennung nach Europa. Außerdem ist es bei diesem Typ nicht möglich, an portierte Rufnummern zu senden. Zusätzlich kann es Probleme bei Sonderzeichen geben<br />
:* '''4''' (Kosten: 0,10 EUR pro SMS): Die Preise sind jeweils gültig für eine verschickte SMS mit 160 Zeichen. Nachrichten mit mehr als 160 Zeichen werden nach der Anzahl der verschickten SMS berechnet, wobei je SMS bei einer überlangen Nachricht 8 Zeichen weniger zur Verfügung stehen. Eine SMS mit z.B. 310 Zeichen würde also mit dem dreifachen SMS Preis berechnet werden. Bei SMS mit Unicodezeichen, also Zeichen, die nicht im Standard GSM Alphabet enthalten sind (z.B. Kyrillisch, Arabisch etc.), sind nur 70 Zeichen je SMS möglich. Der Preis gilt dann für jeweils 70 Zeichen. Kein Versand an Sonderrufnummern.
:Achtung: Bei Typ 3 ist kein Versand an portierte Rufnummern möglich. Bitte Typ 2 oder Typ 4 verwenden!!!</li>
</li>
:* Typ 4: Direktdeutscher Versand mit Absenderkennung
 
Hier wäre es Typ 3.</li>
<li>'''empfaenger''': Geben Sie hier die Handynummer des Empfaengers an. Bei SMS an nicht deutsche Betreiber geben Sie bitte die Auslandsvorwahl in folgendem Format an &quot;0049&quot;. In dem oben aufgeführten Bespiel wird die SMS an die Nummer &quot;01711234567&quot; versendet.</li>
<li>'''empfaenger''': Geben Sie hier die Handynummer des Empfaengers an. Bei SMS an nicht deutsche Betreiber geben Sie bitte die Auslandsvorwahl in folgendem Format an &quot;0049&quot;. In dem oben aufgeführten Bespiel wird die SMS an die Nummer &quot;01711234567&quot; versendet.</li>
<li>'''absender''': Sie können einen eigenen Absender angeben. Bei Typ 3 sind 11 Zeichen numerisch und bei Typ 4 16 Zeichen numerisch bzw. 11 Zeichen alpha möglich. Im Beispiel ist der Absender &quot;Ich&quot;.</li>
<li>'''absender''': Sie können einen eigenen Absender angeben. Bei Typ 4 sind 16 Zeichen numerisch bzw. 11 Zeichen alpha möglich. Im Beispiel ist der Absender &quot;Ich&quot;.</li>
<li>'''content''': Hier geben Sie den Inhalt Ihrer SMS an. Im obigen Beispiel ist es: &quot;Dies ist eine Test-SMS&quot;</li></ul>
<li>'''content''': Hier geben Sie den Inhalt Ihrer SMS an. Im obigen Beispiel ist es: &quot;Dies ist eine Test-SMS&quot;</li></ul>


<span id="3"></span>
==Statusmeldungen ==
===Statusmeldungen ===
 
Bei dem Versand über das HTTP-Gateway sind die nachfolgenden Statusmeldungen möglich. Die Meldungen von 100 - 150 kommen direkt von dem SMS-Gateway, die Meldungen ab 200 sind Artfiles-intern:
Bei dem Versand über das HTTP-Gateway sind die nachfolgenden Statusmeldungen möglich. Die Meldungen von 100 - 150 kommen direkt von dem SMS-Gateway, die Meldungen ab 200 sind Artfiles-intern:


Aktuelle Version vom 8. März 2023, 14:26 Uhr

Funktion des SMS-Gateways

Das HTTP-Gateway dient dazu, Kurzmitteilungen über Ihre eigenen Skripte zu versenden. Der Versand erfolgt per Aufruf einer URI mit bestimmten Parametern.

Um SMS über das HTTP-Gateway versenden zu können, müssen Sie zuvor einen SMS-User im DCP anlegen, welchem der Versand über das HTTP-Gateway gestattet sein muss. Informationen zum Anlegen eines SMS-User finden Sie hier: SMS-User anlegen

URI zum Versenden:
http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&password=test123&type=4&empfaenger=01711234567&absender=Ich&content=Dies ist eine Test SMS

Beschreibung der Parameter

  • user: Dies ist der Name des SMS-Users, den Sie im DCP angelegt haben. In der Beispiel-URI wäre der Username "artfiles"
  • password: Hier geben Sie das zu dem SMS-User gehörende Passwort an. In dem Beispiel: "test123". Das Passwort darf eine max. Länge von 32 Zeichen haben.
  • type: Über diesen Parameter können Sie den Typ der SMS auswählen.
  • 4 (Kosten: 0,10 EUR pro SMS): Die Preise sind jeweils gültig für eine verschickte SMS mit 160 Zeichen. Nachrichten mit mehr als 160 Zeichen werden nach der Anzahl der verschickten SMS berechnet, wobei je SMS bei einer überlangen Nachricht 8 Zeichen weniger zur Verfügung stehen. Eine SMS mit z.B. 310 Zeichen würde also mit dem dreifachen SMS Preis berechnet werden. Bei SMS mit Unicodezeichen, also Zeichen, die nicht im Standard GSM Alphabet enthalten sind (z.B. Kyrillisch, Arabisch etc.), sind nur 70 Zeichen je SMS möglich. Der Preis gilt dann für jeweils 70 Zeichen. Kein Versand an Sonderrufnummern.
  • empfaenger: Geben Sie hier die Handynummer des Empfaengers an. Bei SMS an nicht deutsche Betreiber geben Sie bitte die Auslandsvorwahl in folgendem Format an "0049". In dem oben aufgeführten Bespiel wird die SMS an die Nummer "01711234567" versendet.
  • absender: Sie können einen eigenen Absender angeben. Bei Typ 4 sind 16 Zeichen numerisch bzw. 11 Zeichen alpha möglich. Im Beispiel ist der Absender "Ich".
  • content: Hier geben Sie den Inhalt Ihrer SMS an. Im obigen Beispiel ist es: "Dies ist eine Test-SMS"

    • Statusmeldungen

    Bei dem Versand über das HTTP-Gateway sind die nachfolgenden Statusmeldungen möglich. Die Meldungen von 100 - 150 kommen direkt von dem SMS-Gateway, die Meldungen ab 200 sind Artfiles-intern:

    • 100: SMS angekommen
    • 101: SMS angekommen
    • 110: Falsche Benutzerdaten
    • 112: Keine Berechtigung
    • 120: Absendernummer ungültig
    • 121: Zielrufnummer ungültig
    • 123: Kein Text übergeben
    • 124: ungültiger SMS-Typ
    • 130: Unzulässige Inhalte
    • 131: Rufnummer existiert nicht
    • 132: Empfang evtl. nicht möglich
    • 133: Carrier verweigert die Ausgabe von Informationen
    • 134: Angefragte Rufnummer ist ungültig
    • 150: Reloadsperre
    • 200: Authentifizierungsfehler
    • 201: Limit erreicht
    • 202: HTTP ist nicht erlaubt
    • 203: Ungültiger Empfaenger
    • 204: Kein Absender
    • 205: Ungültiger Typ
    • 206: Kein Inhalt
    Abgerufen von „https://support.artfiles.de/index.php?title=SMS_HTTP-Gateway&oldid=7669“