Specifiche tecniche
PDF Stampa E-mail


METODO 1
scarica documentazione PDF

POST /GET HTTP

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:

$textout1=str_replace("%","%25",$textout1);
$textout1=str_replace("&","%26",$textout1);
$textout1=str_replace("€","%A4",$textout1);
$textout1=str_replace("?","%3F",$textout1);
$textout1=str_replace("+","%2B",$textout1);
$textout1=str_replace(",","%2C",$textout1);
$textout1=str_replace("#","%23",$textout1);
$textout1=str_replace("$","%24",$textout1);
$textout1=str_replace("!","%21",$textout1);
$textout1=str_replace("'","%27",$textout1);
$textout1=str_replace("(","%28",$textout1);
$textout1=str_replace(")","%29",$textout1);
$textout1=str_replace("*","%2A",$textout1);
$textout1=str_replace("-","%2D",$textout1);
$textout1=str_replace(".","%2E",$textout1);
$textout1=str_replace("/","%2F",$textout1);
$textout1=str_replace(":","%3A",$textout1);
$textout1=str_replace(";","%3B",$textout1);
$textout1=str_replace("<","%3C",$textout1);
$textout1=str_replace("=","%3D",$textout1);
$textout1=str_replace(">","%3E",$textout1);
$textout1=str_replace("_","%5F",$textout1);
$textout1=str_replace("?","%C7",$textout1);
$textout1=str_replace("§","%A7",$textout1);
$textout1=str_replace("{","%8",$textout1);
$textout1=str_replace("}","%2",$textout1);
$textout1=str_replace("\\","%2F",$textout1);
$textout1=str_replace("|","%00",$textout1);
$textout1=str_replace("\"","%22",$textout1);
$textout1=str_replace(" ","%20",$textout1);

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:

https://www.kdev.it/report.php?user=USER&passkey=PASSKEY

METODO 2

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 é
Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo. invia una mail a:

Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo. sostituendo le x con il numero del dispositivo mobile desiderato, il soggetto della mail sarà recapitato come SMS.

METODO 3

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 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 )