Schnittstellen

SMS per SOAP

Für den SMS-Versand steht jetzt auch ein Webservice zur Verfügung .

API

Adresse: http://www.sloono.de/API/soapsms.php
Definition (WSDL): http://www.sloono.de/API/wsdl.php?soapsms1

Falls mit der Definition bei Programmen Probleme auftauchen sollten die Adresse http://www.sloono.de/API/soapsms.php?wsdl verwenden.

Anfrage

Für die Anfrage ist der komplexe Datentyp SMS1 notwendig.

Feld Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
typ Zahl/Text

Welcher SMS-Typ soll gesendet werden:

  • 0 oder Discount
  • 1 oder Basic oder Lite
  • 2 oder Pro
  • 3 oder FLASH
Bei dieser Variable kann entweder die Nummer oder der Text verwendet werden. typ=0 und typ=Discount haben die gleiche Wirkung.		 0
timestamp Zahl UNIX-Timestamp der genünschten Sendezeit. Bei 0 oder einem vergangenem Zeitpunkt wird sofort gesendet. 0
text Text SMS-Text mit maximal 1600 Zeichen.  
from Zahl

Absenderkennung:

  1. Handynummer
  2. Absenderkennung 1
  3. Absenderkennung 2
  4. Absenderkennung 3
  5. Absenderkennung 4
 1
to Text Zielnummern getrennt durch Komma (,) und im nationalen oder internationalen Format (0123/456789 oder +49(123)456789). Es können auch die Spitznamen aus dem Adressbuch oder Vor- + Nachname aus dem Adressbuch benutzt werden.  
action Text Es können die Werte info oder send gesetzt werden. Der Wert send überträgt die SMS ins System von sloono, während info nur Informationen über die SMS wie z. B. Preis zurück gibt. Nach dem senden werden die gleichen Informationen zurück gegeben. send

Alle Variablen, die keinen Standartwert haben müssen gesetzt werden!

Antwort

Als Antwort wird ein Datensatz vom komplexe Datentyp Antwort zurückgegeben.

Feld Typ Beschreibung
code Zahl Antwortcode (Liste der Antwortcodes)
codetext Text Textbeschreibung des Antwortcodes.
info Zahl/Text

Informationen über den Status, Fehlermeldungen oder Informationen über die SMS.

Quellcodebeispiele

PHP

Für das PHP-Beispiel ist die Klassensammlung NuSOAP erforderlich.

Beispiel

.NET

Das folgende Beispiel ist in VB.NET (VS 2003) erstellt worden.

Beispiel:

  1. Als erstes muss ein neues VB-Projekt erstellt werden
  2. Projekt > Webverweis hinzufügen ...
    • URL: http://www.sloono.de/API/soapsms.php?wsdl
    • Webverweisname: sloonoSMS
    Weiter mit Verweis hinzufügen.
  3. Nun kann Sourcecode geschrieben werden. Z. B. folgenden Code:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23		 'Webservice-Objekt
Dim WS As New sloonoSMS.soapsms1

'SMS
Dim WSFrage As New sloonoSMS.SMS1
WSFrage.action = "send"
WSFrage.from = 1
WSFrage.password = MD5_Hash("Musterpasswort")
WSFrage.text = "SMS-Text"
WSFrage.timestamp = New System.UInt64
WSFrage.timestamp.Parse("0")
WSFrage.to = "+49(123)4567890"
WSFrage.typ = "Discount"
WSFrage.user = "Musternickname"

'Antwort
Dim WSAntwort As sloonoSMS.Antwort
WSAntwort = WS.smssenden1(WSFrage)

'Auswerten:
' WSAntwort.code
' WSAntwort.codetext
' WSAntwort.info
Eine fertige .NET-Klasse zum SMS versenden mit Beispiel gibt es hier.