SendSMS.aspx

HTTP-Schnittstelle zum SMS-Versand per einfachem GET- oder POST-Aufruf (ohne SOAP)

SendSMS.aspx ist die einfache HTTP-Schnittstelle des Gateways zum Versand einzelner SMS. Im Gegensatz zu den SOAP-Funktionen (Send.asmx) benötigen Sie hier keinen SOAP-Client – ein normaler HTTP-Aufruf über die URL (GET) oder als Formular-POST genügt. Intern ruft die Seite die Funktion SendSimpleSMS auf.

Hauptzweck: Die Seite ist vor allem dafür gedacht, dass keine XML-Antwort verarbeitet werden muss. Über die Parameter OnSuccess und OnError legen Sie selbst fest, welcher Text zurückgegeben wird. So lässt sich die Antwort exakt an das Format anpassen, das eine andere Software für die Integration erwartet (z. B. ein einfaches OK, eine reine JobId oder ein eigener Fehlercode) – ganz ohne XML-Parsing.

Über den Parameter SmsTyp wählen Sie den gewünschten SMS-Typ (auch Festnetz-SMS), über SendDate ist ein zeitversetzter Versand möglich. Je nach SMS-Typ kann die maximale Textlänge variieren.

Service-URL

Endpunkt	https://www.smscreator.de/gateway/SendSMS.aspx
Methoden	GET (Query-String) oder POST (Formular bzw. text/xml-Body)
Rückgabe	XML (SOAPResponse) – oder Ihr eigener Text bei Verwendung von OnSuccess/OnError

Hinweis: Bitte den genauen Pfad mit Ihrem Gateway-Setup abgleichen (z. B. /gateway/).

Parameter

Die Parameter können wahlweise im Query-String (GET) oder als POST-Parameter übergeben werden.

Parameter	Pflicht	Beschreibung
User	ja	Benutzername bzw. Seriennummer Ihres Zugangs.
Password	ja	Ihr Passwort.
Recipient	ja	Empfängernummer im internationalen Format, z. B. 491701234567.
SMSText	ja	Der Nachrichtentext. URL-kodiert übergeben (Leer- und Sonderzeichen).
Sender	optional	Absenderkennung (Rufnummer oder alphanumerisch, je nach SMS-Typ und Freischaltung).
Caption	optional	Frei wählbare Auftragsbezeichnung (JobCaption) zur späteren Zuordnung.
SmsTyp	optional	SMS-Typ als Name (z. B. HighQuality) oder als Zahl. Standard: Standard. Siehe SMS-Typen.
SendDate	optional	Versandzeitpunkt für zeitversetzten Versand, z. B. 2026-06-12 14:30:00. Ohne Angabe: sofortiger Versand.
OnSuccess	optional	Eigener Antworttext bei Erfolg. Platzhalter %JOBID% wird durch die JobId ersetzt. Ohne Angabe wird die XML-Antwort zurückgegeben.
OnError	optional	Eigener Antworttext im Fehlerfall. Platzhalter %ERROR% wird durch den Statuscode ersetzt.

Aufruf-Beispiele

1. GET (Query-String)

https://www.smscreator.de/gateway/SendSMS.aspx?User=IhrBenutzer&Password=IhrPasswort&Recipient=491701234567&Sender=Firma&SMSText=Hallo%20Welt&SmsTyp=HighQuality

2. POST (Formular, application/x-www-form-urlencoded)

POST /gateway/SendSMS.aspx HTTP/1.1
Host: www.smscreator.de
Content-Type: application/x-www-form-urlencoded

User=IhrBenutzer&Password=IhrPasswort&Recipient=491701234567&Sender=Firma&SMSText=Hallo%20Welt&SmsTyp=HighQuality

3. Eigener Antworttext (OnSuccess / OnError)

...&OnSuccess=OK:%JOBID%&OnError=FEHLER:%ERROR%

Erfolgsantwort dann z. B.: OK:123456 – im Fehlerfall z. B.: FEHLER:NoRecipientFound.

cURL

curl "https://www.smscreator.de/gateway/SendSMS.aspx" \
  --data-urlencode "User=IhrBenutzer" \
  --data-urlencode "Password=IhrPasswort" \
  --data-urlencode "Recipient=491701234567" \
  --data-urlencode "Sender=Firma" \
  --data-urlencode "SMSText=Hallo Welt" \
  --data-urlencode "SmsTyp=HighQuality"

Antwort (Rückgabe)

Empfohlen: angepasste Antwort (kein XML)

Für Integrationen geben Sie OnSuccess und/oder OnError mit. Dann liefert die Seite genau diesen Text zurück statt XML. Verfügbare Platzhalter: %JOBID% (bei Erfolg) und %ERROR% (im Fehlerfall).

Aufruf:   ...&OnSuccess=OK:%JOBID%&OnError=FEHLER:%ERROR%
Erfolg:   OK:123456
Fehler:   FEHLER:NoRecipientFound

So passen Sie die Rückgabe an das Format an, das Ihre Zielsoftware erwartet – z. B. nur OK, nur die JobId, einen HTTP-tauglichen Statustext o. Ä.

Standard ohne OnSuccess/OnError: XML

Ohne OnSuccess/OnError liefert die Seite ein serialisiertes SOAPResponse-XML zurück. Die Auswertung erfolgt in zwei Stufen: StatusCode (Anmeldung/System) und Value/Status (auftragsspezifisch).

<SOAPResponse>
  <StatusCode>Ok</StatusCode>
  <Value>
    <Status>Ok</Status>
    <JobId>123456</JobId>
  </Value>
</SOAPResponse>

Erfolg liegt vor, wenn StatusCode = Ok und Value/Status = Ok. Die JobId ist eine Übermittlungsbestätigung, jedoch keine Zustellbestätigung. Zustellberichte werden separat abgeholt.

SMS-Typen (SmsTyp)

Wert	Beschreibung
Standard	Versand über Modem mit variierender Absendernummer und Antwortfunktion.
StandardDLR	Versand über Modem mit Statusbericht / Nummerncheck.
StandardLong	Versand über Modem mit variierender Absendernummer; lange SMS werden zusammengehängt.
Flash	Flash-SMS; wird i. d. R. nicht auf dem Empfängergerät gespeichert.
HighQuality	Versand über SMSC-Anbindung mit Absenderkennung und Zustellbericht.
HighQualityLong	Wie HighQuality, lange SMS werden zusammengehängt.
Festnetz	SMS-Versand an Festnetznummern.
HLR	HLR-Abfrage (Gültigkeits- und Providerprüfung einer Mobilnummer).

Der Wert kann als Name oder als entsprechende Zahl übergeben werden. Ein ungültiger Wert führt zu SMSTypeError.

Statuscodes

StatusCode (Anmeldung / System)

Code	Bedeutung
None	Es wurden keine Informationen vom System zurückgeliefert.
Ok	Funktionsaufruf erfolgreich ausgeführt.
InvalidUser	Ungültiger Benutzer.
AccountLocked	Account gesperrt.
IPLock	Ihre IP-Adresse wurde nicht freigeschaltet.
DatabaseError	Fehler in der Datenbank.

Value / Status (auftragsspezifisch)

Code	Bedeutung
Ok	Auftrag erfolgreich übermittelt.
NoTextFound	Kein SMS-Text angegeben.
NoRecipientFound	Kein Empfänger gefunden.
NoUrlFound	Keine Angabe im Feld URL.
SMSTypeError	Fehler bei der Angabe des SMS-Typs.
DuplicateSMSJobFound	SMS-Auftrag doppelt vorhanden.
LoginError	Fehler beim Login.
CellPhoneNotValid	Ungültige Mobilfunknummer.
LandlineNotValid	Ungültige Festnetznummer.
UnknowError	Unbekannter Fehler.

Vollständige Liste siehe Server Status.

Hinweise: Übergeben Sie SMSText, Sender und weitere Werte stets URL-kodiert. Der Versand der Zugangsdaten sollte ausschließlich über HTTPS erfolgen. Die Verfügbarkeit einzelner SMS-Typen und Absenderkennungen hängt von Ihrer Freischaltung ab.

Rufen Sie uns an.

Lösungen finden

Lassen Sie sich unverbindlich von unseren Experten der Netxp beraten! Wir finden die Lösung für Ihre Anforderungen.
Schnell - Präzise - Zuverlässig.

Ihre Nachricht