L'intégration de la solution s'est avérée transparente et nous n'avons pas connu de problèmes depuis notre lancement il y a plus d'un an. Merci Esendex!
Andy Emery, Konica Minolta
Esendex fournit une interface de service Web SOAP qui permet aux développeurs d'intégrer une fonctionnalité SMS à leurs applications. Tous les services sont accessibles par le biais des protocoles HTTP ou HTTPS.
Il existe deux versions de l'API SMS XML SOAP. Cette page décrit l'interface principale qui exploite les en-têtes SOAP pour transporter les informations d'authentification (compte, nom d'utilisateur et mot de passe).
Il existe plusieurs environnements, par ex., Coldfusion, qui ne prennent pas en charge les en-têtes SOAP. Le service SOAP XML SMS API - No Headers intègre les informations d'authentification dans les arguments de chaque appel de méthode.
Des exemples complets de mises en œuvre sont fournis avec les kits de développement SMS et nous conseillons aux personnes intéressées par les méthodes d'API SOAP de commencer par là. Si vous souhaitez une assistance, veuillez contacter le support@esendex.com.
Les fonctionnalités de l'API SMS XML SOAP sont mises en œuvre par plusieurs services :
Envoi
| Service | Description | |
|---|---|---|
| SendService | Méthodes d'envoi de messages SMS individuellement et par lots | URI,WSDL |
| SendContentService | Méthodes d'envoi de messages SMS à des fins de transmission de contenu, par ex., Push WAP, individuellement et par lots | URI,WSDL |
| ScheduledSendService | Transmet à Esendex un message planifié pour être envoyé à une date/heure ultérieure | URI,WSDL |
Remarques
La fonctionnalité de dénomination de service des méthodes SendMessageFull et SendMessageMultipleRecipientsFull n'est pas disponible pour les comptes d'évaluation ou Premium. Lorsque vous utilisez ces méthodes, vous devez définir le paramètre Émetteur de votre référence de compte, sinon vous recevrez un message d'erreur lors de votre tentative d'envoi de message.
Réception
| Service | Description | |
|---|---|---|
| InboxService | Gère les messages entrants mis en file d'attente dans la boîte de réception du compte | URI,WSDL |
| AccountEventHandler | Permet à notre système de notifier le vôtre en cas d'événement de compte, par exemple la réception d'un message. Il s'agit d'une definition d'interface pour un service Web, de votre création, sur votre serveur Web public. Pour plus d'informations, consultez Gestionnaire d'événement de compte. |
URI,WSDL |
Remarques
Une fois AccountEventHandler créé sur votre serveur public, configurez l'appel de votre service Web par votre compte dans la section Notification de compte de la page Options Messenger.
Nous vous recommandons, à la réception d'un message via le service AccountEventHandler, de le supprimer de la boîte de réception via le service InboxService. Cela permet à votre système de terminer la transaction de réception de message tout en maintenant une file d'attente de messages, en cas d'indisponibilité de votre serveur à l'arrivée d'un message.
Autre
| Service | Description | |
|---|---|---|
| AccountService | Fonctionnalité de gestion de compte | URI,WSDL |
| ContactService | Fonctionnalité de gestion des contacts et des groupes de contacts | URI,WSDL |
| SubscriptionService | Fonctionnalité de gestion d'abonnement | URI,WSDL |
Erreurs
Si une erreur survient lors de l'envoi d'une demande à un service Web, vous recevrez une erreur SOAP qui décrit le problème. Ces informations, qui se trouvent dans la section Détail du code XML, sont constituées de deux nœuds ErrorCode et ErrorMessage. Il existe une liste complète de Codes d'erreur qui vous aidera à diagnostiquer les problèmes.
