Developer smSend: invio messaggi mms tramite Web Service SOAP

indietro

A.P.I. Developer Guide
Sviluppa la tua applicazione integrando le funzioni sms e mms

Creazione clienti in post HTTP

Assegnazione crediti in post HTTP

Controllo crediti in post HTTP

Controllo operazioni back-office in post HTTP

Creazione e assegnazione ricezione in post HTTP

Revoca servizio di ricezione in post HTTP

Attivazione / disattivazione clienti in post HTTP

Invio singolo SMS in post HTTP

Invio multiplo SMS in post HTTP

Invio richieste multiple MNC in post HTTP

Controllo stato spedizioni sms post http

Controllo stato spedizioni in post HTTP

Controllo crediti SMS in post HTTP

Controllo messaggi ricevuti con post http dal Gateway

Controllo messaggi ricevuti tramite web service SOAP

Controllo messaggi ricevuti tramite SOAP

Repository delle A.P.I. smSend su Github

Invio messaggi MMS tramite web service SOAP

Controllo tariffe SMS standard (xml)

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

Manuale Software

Manuale Rivenditore

Codifica caratteri

Manuale A.P.I.

Invio messaggi mms tramite Web Service SOAP

POST URL: http://(dnsservice).smsend.it/sms-gw/?wsdl

Il dnsservice verrà abilitato solo su richiesta:
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'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.

Repository 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

indietro

torna su