SMS HTTP-Gateway: Unterschied zwischen den Versionen
Ks (Diskussion | Beiträge) |
Rb (Diskussion | Beiträge) |
||
| (9 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | [[category:DCP]] | + | [[category:DCP]][[category:fertig]] |
| − | + | ==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. | ||
| − | 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: [[ | + | 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|SMS-User anlegen]] |
'''URI zum Versenden:'''<br /> | '''URI zum Versenden:'''<br /> | ||
| − | http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&password=test123&type= | + | [http://sms.artfiles.de/cgi-bin/sms_gateway.pl?user=artfiles&password=test123&type=4&empfaenger=01711234567&absender=Ich&content=Dies%20ist%20eine%20Test%20SMS 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"</li> | |
| + | *'''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.</li> | ||
| + | *'''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. | |
| − | + | </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 "0049". In dem oben aufgeführten Bespiel wird die SMS an die Nummer "01711234567" 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 "0049". In dem oben aufgeführten Bespiel wird die SMS an die Nummer "01711234567" versendet.</li> | ||
| − | <li>'''absender''': Sie können einen eigenen Absender angeben. Bei Typ | + | <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 "Ich".</li> |
<li>'''content''': Hier geben Sie den Inhalt Ihrer SMS an. Im obigen Beispiel ist es: "Dies ist eine Test-SMS"</li></ul> | <li>'''content''': Hier geben Sie den Inhalt Ihrer SMS an. Im obigen Beispiel ist es: "Dies ist eine Test-SMS"</li></ul> | ||
| − | + | ==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, 15: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.
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