• Home/
• SMS Gateway/
• Specifiche API

Post/Get HTTP

Accesso al gateway SMS

Per poter utilizzare le API l'utente dovrà abilitare l'accesso e configurare il suo IP nel pannello di configurazione della propria area riservata all'indirizzo:
https://www.smskdev.it/highway

La sicurezza delle transazioni é assicurata da Verisign®. Il sistema accetta sia GET che POST.

Doku Wiki - Esempio chiamata GET

Eseguito il login accedere dal menù alla sezione Il Mio Account > Configurazione Utente.

• Scegliere SI dalla dropdown in corrispondenza dell'opzione "Abilita Webservice ".
• Specificare l'IP o gli IP dai quali saranno lanciate le chiamate nel campo in corrispondenza dell'opzione "WebService Ip Range", per aprire il Webservice su tutte le reti specificare *.*.*.*

Invio SMS tramite http

Per l'invio di un SMS é sufficiente una chiamata HTTPS.
Esempio di chiamata per invio SMS:

https://www.smskdev.it/highway/send.php?user=utente&passkey=utente&to=39XXXXXXXXXX&text=testo%20messaggio

Nota bene: il testo dell'SMS deve essere condificato secondo lo standard URLENCODE

output della chiamata in formato JSON

stdClass Object
(
  [data] => Array
    (
      [0] => stdClass Object
        (
          [status] => OK
          [error] => 0
          [smslog_id] => 5496
          [queue] => b09035435513302c1beb6a29224c9976
          [to] => 39XXXXXXXX
        )
    )
    [error_string] => 
    [timestamp] => 1413318506
)

Come si può vedere dall'esempio, il tracciato riporta:

• [status] OK - Esito dell'accodamento (OK o KO)
• [error] 0 - Eventuale codice errore
• [smslog_id] 5496
• [queue] b09035435513302c1beb6a29224c9976
• [to] 39XXXXXXXX

Codici di errore

Le operazioni concluse con successo riporteranno la dicitura "OK" nei messaggi di conferma
La tabella riportante i codici di errore delle chiamate fallite è disponibile sulla KDEV SMS Doku Wiki.

Doku Wiki - Tabelle di errore

DLR - Notifica di ricezione

Ogni SMS inviato viene accompagnato da un Delivery Report "ricevuta di ritorno"
I Delivery Report (DLR) sono serviti in formato .CSV.

I DLR contengono il codice di riferimento dell¹operazione, fai riferimento alla tabella codici per conoscere l'esito

SMTP o funzione email to SMS

Al momento dell'attivazione riceverete una mail con il seguente testo:

Il mittente abilitato alla funzione MAIL to SMS é [email protected]. Invia una mail a: [email protected] sostituendo le x con il numero del dispositivo mobile desiderato, il soggetto della mail sarà recapitato come SMS.

Upload di file CSV

Nella mail di attivazione verranno forniti i parametri FTP per accedere alla propria area utente, mediante questi parametri potrete caricare via FTP o SFTP un file CSV nel formato:

mittente;numero_cellulare_destinazione;testo del messaggio

Una volta caricato, il file CSV verrà automaticamente spedito entro 3 minuti.

Sulla KDEV SMS Doku Wiki potrai trovare esempi di codice della API del servizio KDEV SMS Gateway, pronti per esser copiati, modificati ed utilizzati!

KDEV SMS - Documentazione ufficiale