Developer guide

invio messaggi mms tramite Web Service SOAP

Grazie alle A.P.I. (Application Programming Interface)
di smSend puoi oggi integrare tutte le funzioni del nostro
software all'interno della tua applicazione, software o sito web.

 


Documentazione
Scarica i manuali del software e la documentazione A.P.I.
 

 

Invio messaggi mms tramite Web Service SOAP

POST URL: http://(dnsservice).smsend.it/sms-gw/?wsdl
 
E' necessario l'acquisto del servizio DNS dedicato.
 
Richiamare il metodo sendMms con i parametri specificati alla voce "Input"
 
Input:
string sendMms ( string id, string password, string ticket, string subject, string text, string rcpt, [
base64Binary imagedata ], [ base64Binary sounddata ] )
 
Id:
è un parametro obbligatorio. l'Id verrà rilasciato dal personale tecnico smSend.
 
password:
è un parametro obbligatorio se l'autenticazione associata all' account e' di tipo plain-password. Il suo valore deve essere la password dell'account utilizzando fornita da smSend.

ticket:
è un parametro obbligatorio se l'autenticazione associata all' account è di tipo MD5.
Usato come token di autenticazione. Il valore del ticket deve essere ricavato applicando la funzione hash MD5 (con output in esadecimale, lowercase) alla stringa risultante dalla concatenazione dei parametri: id, rcpt, subject, text, password.
Il valore del parametro password viene fornito all'atto dell'attivazione dell'account.
L'autenticazione è soddisfatta se l'hash MD5 ricalcolato dal gateway sui parametri ricevuti e la copia locale della password, è uguale al ticket ricevuto.

subject:
è un parametro obbligatorio. Contiene l'oggetto del messaggio e può avere lunghezza massima di 25 caratteri.

text
è un parametro obbligatorio. Contiene il testo del messaggio e può avere lunghezza massima di 2400 caratteri.

rcpt:
è un parametro obbligatorio. Indica il numero o i numeri del terminale mobile a cui spedire il messaggio, secondo il formato internazionale +JJxxxyyyzzkk (Es.: +393112224455).
Nel caso di invio multiplo, i numeri devono essere separati da una virgola
(Es.: “+393112224455,+393114445566,+393229998877”).

imagedata:
è un parametro opzionale. Deve contenere i dati dell'immagine da inserire nel messaggio.
I formati supportati sono JPEG, GIF e PNG e le dimensioni del file allegato non devono superare i 100 kbyte. Attenzione, il campo è di tipo base64Binary e deve essere composto dal contenuto del file di immagine codificato tramite l'algoritmo base64.

sounddata:
è un parametro opzionale. Deve contenere i dati del file audio da inserire nel messaggio.
I formati supportati sono MIDI e MP3 e le dimensioni del file allegato non devono superare i 100 kbyte. Attenzione, il campo è di tipo base64Binary e deve essere composto dal contenuto del file audio codificato tramite l'algoritmo base64.

videodata:
è un parametro opzionale. Deve contenere i dati dell'video da inserire nel messaggio.
I formati supportati sono MOV e 3GP e le dimensioni del file allegato non devono superare i 100 kbyte. Attenzione, il campo è di tipo base64Binary e deve essere composto dal contenuto del file video codificato tramite l'algoritmo base64.
OUTPUT:
La transazione ritorna una variabile response di tipo stringa contenente il credito sottratto per la spedizione espresso in decimillesimi di euro. Se l'inoltro non è andato a buon fine verrà ritornata una struttura Fault contenente il codice e la descrizione dell'errore verificatosi.
Risposta del webservice in caso di invio con successo:

HTTP/1.1 200 OK
Content-Length: 512
Content-Type: text/xml; charset=ISO-8859-1
<?xml version="1.0" encoding="ISO-8859-1"?>
<SOAP-ENV:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
   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:sendMmsResponse xmlns:ns1="urn:sendMmswsdl">
      <response xsi:type="xsd:int">3700</response>
      </ns1:sendMmsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
 
Risposta del webservice in caso di invio fallito:

HTTP/1.1 500 Internal Server Error
Status: 500 Internal Server Error
Content-Length: 663
Content-Type: text/xml; charset=ISO-8859-1
<?xml version="1.0" encoding="ISO-8859-1"?>
<SOAP-ENV:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
   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>
      <SOAP-ENV:Fault>
         <faultcode xsi:type="xsd:string">KO 211</faultcode>
         <faultactor xsi:type="xsd:string"></faultactor>
         <faultstring xsi:type="xsd:string">quota_abs reached</faultstring>
         <detail xsi:type="xsd:string"></detail>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Richiesta di invio MMS con immagine e password in chiaro
(autenticazione basata sull'IP)

Host: www.smsend.it
Content-Type: text/xml; charset=ISO-8859-1
"urn:sendMmswsdl#sendMms"
Content-Length: 1377
<?xml version="1.0" encoding="ISO-8859-1"?>
<SOAP-ENV:Envelope
    SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    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/"
    xmlns:tns="urn:sendMmswsdl">
    <SOAP-ENV:Body>
       <tns:sendMms xmlns:tns="urn:sendMmswsdl">
          <id xsi:type="xsd:string">C00000_001</id>
          <password xsi:type="xsd:string">password</password>
          <ticket xsi:type="xsd:string"></ticket>
          <subject xsi:type="xsd:string">Oggetto</subject>
          <text xsi:type="xsd:string">Testo dell&apos;MMS</text>
          <rcpt xsi:type="xsd:string">+393477005440</rcpt>
          <imagedata
          xsi:type="xsd:base64Binary">R0lGODlhEAAQANUAAAA(...)</imagedata>
          <sounddata xsi:nil="true" xsi:type="xsd:base64Binary"/>
       </tns:sendMms>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Codici di errore:
KO 101 not allowed
KO 102 operation not permitted
KO 103 bad recipient
KO 104 not allowed
KO 105 not allowed
KO 106 not allowed
KO 107 no auth suitable
KO 109 carrier problem
KO 110 Msg Blocked
KO 111 banned
KO 124 text too long
KO 211 quota_abs reached (credito non disponibile)
KO 213 quota_ny reached (notifiche non disponibili)
KO 215 Image file cannot be bigger than 100kB
KO 216 Image file type not supported

 

KO 217 Sound file bigger than 100kB
KO 218 Sound file type not supported
KO 300 System (Internal Error)
KO 301 (Connection Problem)
KO 302 (Generic Error)
KO 303 (Connection Problem)
KO 310 type unsupported
KO 311 send error
KO 400 (Internal Error)
KO 401 (Internal Error)
KO 402 (Internal Error)
KO 500 ERROR (Internal Error)
KO 501 ERROR (Internal Error)
KO 502 (Internal Error)
KO 555 Relay Error

 

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.
N.B. Devi avere un account smSend.
N.B. Id, password e dns di accesso verranno forniti su richiesta.

Github - Social codingRepository delle A.P.I. smSend su Github

Contribuisci e crea anche tu progetti unici con il repository delle A.P.I. smSend su Github - social coding - http://github/smsend