SOAP est un protocole d’appel de procédure distante RPC (Remote Procedure Call) orienté objet et bâti sur XML. Il permet la transmission de messages entre objets distants, ce qui veut dire qu’il autorise un objet à invoquer des méthodes d’objets physiquement situés sur un autre serveur, le plus souvent à l’aide du protocole http.
Le protocole SOAP est composé de deux parties :
- un modèle de données, définissant le format du message, c’est-à-dire les informations à transmettre
- une enveloppe, contenant des informations sur le message lui-même afin de permettre son acheminement et son traitement
L’API SOAP AllMySMS.com utilise un fichier WSDL (Web Service Description Language) qui permet de fournir un modèle détaillé sur l’utilisation du Web Service SOAP AllMySMS.com.
Le WSDL permet de décrire:
- le protocole de communication
- le format de messages requis pour communiquer avec le service
- les méthodes que l’on peut invoquer
- la localisation du service
ENVOI DE REQUETES SOAP A LA PLATEFORME ALLMYSMS.COM
Le WSDL pour le web service AllMySMS.com est accessible à l’url suivante :
http://api.msinnovations.com/soap/wsdl.php
Pour envoyer vos requêtes SOAP au serveur AllMySMS.com via HTTP, veuillez envoyer vos données à l’url suivante :
http://api.msinnovations.com/soap/server.php
TESTER NOTRE SERVICE
Nous vous conseillons de tester notre web service SOAP SMS avec le logiciel SoapUI: soapui.org,
Il suffit ensuite d’importer notre projet disponible à cette adresse: SOAP MSINNOVATIONS-soapui-project
DOCUMENTATION
Pour consulter les définitions des objets et toutes les méthodes disponibles veuillez vous reporter à la documentation disponible à cette adresse:
AllMySMS_DocTechnique_Api_SOAP.pdf
SAMPLE
Allmysms.com met à votre disposition des exemples de codes pour que vous testiez nos services plus rapidement:
- Sample PHP5, soapSamplePhp5.zip
REQUÊTE
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://api.msinnovations.com/soap/server.php"> <soapenv:Header/> <soapenv:Body> <ser:sendSms soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <clientCode xsi:type="xsd:string">your login</clientCode> <passCode xsi:type="xsd:string">your password</passCode> <messageData xsi:type="ser:MsInnovations_Api_Soap_Objects_MessageData"> <!--You may enter the following 9 items in any order--> <message xsi:type="xsd:string">lorem ipsum dolor sit amet.</message> <dynamic xsi:type="xsd:int"></dynamic> <campaignName xsi:type="xsd:string">Soap Campaign</campaignName> <cliMsgId xsi:type="xsd:string">your own parameter</cliMsgId> <date xsi:type="xsd:string"></date> <tpoa xsi:type="xsd:string"></tpoa> <mailNotif xsi:type="xsd:int"></mailNotif> <sms xsi:type="ser:ArrayOfMsinnovations_api_soap_objects_sms"> <!--Zero or more repetitions:--> <item xsi:type="ser:MsInnovations_Api_Soap_Objects_Sms"> <!--You may enter the following 2 items in any order--> <mobilePhone xsi:type="xsd:string">33612345678</mobilePhone> <params xsi:type="ser:ArrayOfString"> <!--Zero or more repetitions:--> <item xsi:type="xsd:string"></item> </params> </item> </sms> </messageData> </ser:sendSms> </soapenv:Body> </soapenv:Envelope>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:MsInnovations_Api_Soap_Wsdl" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"> <SOAP-ENV:Body> <ns1:sendSmsResponse> <return xsi:type="SOAP-ENC:Struct"> <status xsi:type="xsd:string">100</status> <statusText xsi:type="xsd:string">Le message a été envoyé</statusText> <credits xsi:type="xsd:string">5000</credits> <invalidNumbers xsi:type="xsd:string"/> <campaignId xsi:type="xsd:string">ap_291195728421</campaignId> <ids SOAP-ENC:arrayType="SOAP-ENC:Struct[1]" xsi:type="SOAP-ENC:Array"> <item xsi:type="SOAP-ENC:Struct"> <mobilePhone xsi:type="xsd:string">33612345678</mobilePhone> <id xsi:type="xsd:string">42224660</id> </item> </ids> </return> </ns1:sendSmsResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>