Esendex war hilfreich bei der Anpassung unser komplexen geschäftlichen Anforderungen und hat einen erstklassigen Service abgeliefert, der sein Geld wert ist.
Anthony Tunley, University of Nottingham
Esendex bietet eine SOAP Web Service-Schnittstelle, die es Entwicklern ermöglicht, SMS -Funktionalität in ihre Anwendungen zu integrieren. Alle Dienste sind entweder über HTTP- oder HTTPS-Protokolle zugänglich.
Es gibt zwei Versionen des SOAP XML SMS API. Diese Seite beschreibt die Primärschnittstelle, die SOAP Header verwendet, um Authentifizierungsinformationen (Konto, Benutzername und Passwort) zu transportieren.
Es gibt diverse Umgebungen, z. B. ColdFusion, die keine Unterstützung von SOAP Headern bieten. Der Dienst SOAP XML SMS API - No Headers enthält die Authentifizierungsinformationen in den Argumenten für jeden Methodenaufruf.
Komplette Beispiel-Implementierungen sind in den SMS SDKs enthalten und wir ermutigen alle, die die Verwendung der Methoden der SOAP API untersuchen möchten, hier zu starten. Wenn Sie Unterstützung benötigen, wenden Sie sich bitte an den supporte@esendex.de.
Das SOAP XML SMS API bietet Funktionalität über die folgenden Dienste:
Senden
| Dienst | Beschreibung | |
|---|---|---|
| SendService | Methoden zum Senden von SMS-Nachrichten - einzeln und im Batch | URI,WSDL |
| SendContentService | Methoden zum Versenden von SMS-Nachrichten zur Auslieferung von Inhalten, z. B. WAP-Push - einzeln oder im Batch | URI,WSDL |
| ScheduledSendService | Übermittelt eine Nachricht an Esendex, die nach Zeitplan zu einem späteren Zeitpunkt (Datum/Uhrzeit) versandt werden soll | URI,WSDL |
Hinweise
Die Dienst-Aliasing-Funktion (Pseudonyme) innerhalb der SendMessageFull- und SendMessageMultipleRecipientsFull-Methoden von SendService ist bei Probe - und Premium-Konten nicht verfügbar. Bei Verwendung dieser Methoden, müssen Sie den Originator-Parameter (Absender-Parameter) auf Ihre Konto-Referenz stellen, sonst erhalten Sie beim Versuch eine Nachricht zu senden eine Fehlermeldung.
Empfangen
| Dienst | Beschreibung | |
|---|---|---|
| InboxService | Verwalten eingehender Nachrichten, die im Posteingang des Kontos in Warteschlange liegen | URI,WSDL |
| AccountEventHandler | Ermöglicht unserem System, Ihr System zu benachrichtigen, wenn Konto-Ereignisse auftreten, z. B. beim Empfang einer Nachricht. Dies ist eine Schnittstellendefinition für einen Web Service, den Sie auf Ihrem öffentlichen Web Server erstellen. Für weitere Informationen vgl. Account Event Handler. |
URI,WSDL |
Hinweise
Sobald der AccountEventHandler auf Ihrem öffentlichen Server erstellt wurde, konfigurieren Sie Ihr Konto zum Anruf Ihres Web-Dienstes im Bereich Konto-Benachrichtigung der Seite Messenger Optionen.
Wir empfehlen, dass eine Nachricht beim Empfang über den AccountEventHandler-Dienst über den InboxService aus dem Posteingang gelöscht wird. So kann Ihr System die Nachrichtenauslieferungs-Transaktion komplettieren und eine Warteschlange aus Nachrichten behalten, wenn Ihr Server bei der Ankunft einer Nachricht nicht verfügbar sein sollte.
Sonstige
| Dienst | Beschreibung | |
|---|---|---|
| AccountService | Kontoverwaltungs-Funktionalität | URI,WSDL |
| ContactService | Funktionalität für die Verwaltung von Kontakten und Kontaktgruppen | URI,WSDL |
| SubscriptionService | Funktionalität zur Abonnementverwaltung | URI,WSDL |
Fehler
Wenn beim Versand einer Abfrage an einen Web Service ein Fehler auftritt, empfangen Sie einen SOAP-Fehler, der beschreibt, was das Problem war. Diese Information befindet sich im Bereich "Detail" der XML und besteht aus den zwei Datenknoten "ErrorCode" und "ErrorMessage". Es gibt eine vollständige Liste von Fehlercodes, die Sie bei der Diagnose von Problemen unterstützt.