Per accedere al gateway SMS via HTTP è necessario passare I parametri all'URL:
https://www.kdev.it/send.php La sicurezza delle transazioni é assicurata da Verisign® Il sistema accetta sia GET che POST allegato file PHP di esempio per una chiamata GET al gateway: scarica esempio di web service PHP
I dati da passare nel payload dell' HTTP sono:
Parametri obbligatori:
• user (username con cui ci si e' registrati)
• passkey (password con cui ci si e' registrati)
• to (destinatario, in forma internazionale +393334455666)
• text (messaggio da spedire, lunghezza massima 160 caratteri)
Parametri opzionali per la gestione del mittente
• vcode (permette di specificare una stringa alfanumerica di lunghezza massima 11 caratteri da utilizzare come mittente) nel caso nessuna stringa é specificata verrà utilizzata una stringa di default impostata in fase di registrazione dell’utenza.
Nota bene: assicurarsi che tutti i dati rispettino quanto elencato in questa pagina, gli SMS utilizzano il charset ISO-8859-15 per gestire correttamente i simboli quali la valuta €
Le sostituzioni da effettuare al testo nella chiamata GET/POST sono le seguenti:
Ovvero il simbolo ad esempio € diventa %A4 tutti gli altri comprese à é è ì ò ù devono essere passati come sono senza nessuna urlencode.
La risposta del gateway riporta come primo parametro l’esito dell’accodamento:
OK- Il messaggio é stato accodato
KO- Il messaggio non é stato preso in carico
Il secondo parametro é il credito residuo
Ad esempio: OK-100 significa messaggio accodato credito residuo 100
I DLR sono serviti in CSV, ATTENZIONE perché una volta richiesti non é più possibile riscaricarli se non su richiesta, il sistema è incrementale, ovvero provvederà a inviare i DLR non ancora scaricati. In questo modo sarà possibile prelevare i DLR mediante un'azione a tempo (cron job) ed eseguire l'inserimento dei nuovi arrivi nel vostro database.
Per ottenere i delivery report la chiamata é la seguente:
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 CVS nel formato:
mittente;numero_cellulare_destinazione;testo del messaggio
Una volta caricato verrà automaticamnete spedito entro 3 minuti.
Ultimo aggiornamento ( Martedì 04 Maggio 2010 18:45 )