Sei un programmatore ?
Per te supporto prioritario, aiuto sul codice, API personalizzate, SMS per sviluppo gratuiti e molto altro.
Scrivici subito

SOAP Web Services (WSDL)

SubitoSMS mette a disposizione un Web Service SOAP per l’invio e il controllo degli SMS tramite WSDL.

Il servizio è pensato per integrazioni legacy o ambienti che richiedono SOAP/RPC anziché HTTP o JSON.

Endpoint SOAP: https://www.subitosms.it/ws.php

WSDL

Il servizio è descritto tramite WSDL e utilizza:

• protocollo SOAP 1.1

• binding RPC/encoded

• namespace: urn:smswsdl

Operazioni disponibili

Il Web Service espone tre operazioni:

• sms – invio SMS o richiesta credito

• sms_check – verifica stato di una spedizione

• send – alias del metodo sms

Metodo: sms

Invia un SMS con mittente e testo al destinatario e restituisce il codice di spedizione.

Se i parametri mittente, destinatario e testo non vengono forniti, il metodo restituisce il credito residuo.

Parametri richiesta (sms)

• username (string) – username SubitoSMS

• password (string) – password SubitoSMS

• mittente (string) – mittente alfanumerico o numero GSM

• destinatario (string) – numero GSM destinatario

• testo (string) – testo del messaggio

Risultato (sms)

Il metodo restituisce una stringa nel campo risultato.

Possibili valori:

• id:CODICE_NUMERICO_SPEDIZIONE

• credito:NUMERO_SMS_RESIDUI

• credito insufficiente

• errore destinatario

• errore mittente

• errore testo

Il valore restituito va sempre interpretato come stringa, non come struttura dati.

Metodo: sms_check

Permette di verificare lo stato di una spedizione SMS precedentemente inviata.

Parametri richiesta (sms_check)

• username (string) – username SubitoSMS

• password (string) – password SubitoSMS

• id (int) – ID numerico della spedizione

Risultato (sms_check)

Il metodo restituisce una stringa contenente lo stato o gli stati della spedizione.

Il formato e i valori degli stati sono gli stessi utilizzati dal gateway HTTP SubitoSMS.

Metodo: send

Alias del metodo sms.

È esposto esclusivamente per compatibilità con ambienti in cui esistono conflitti di nomi con metodi chiamati sms.

Il comportamento, i parametri e il risultato sono identici al metodo sms.

Dettagli SOAP

• Style: RPC

• Encoding: SOAP encoded

• Transport: HTTP

• Namespace: urn:smswsdl

Endpoint del servizio

https://www.subitosms.it:443/ws.php

Note operative

Questo Web Service è pensato principalmente per sistemi legacy o ambienti enterprise che richiedono SOAP.

Per nuove integrazioni si consiglia l’utilizzo del Gateway HTTP o delle JSON API.

Per ulteriori dettagli sugli stati SMS e sulle limitazioni dei mittenti, consulta le FAQ SubitoSMS.