API v1 (deprecated)
danger
Attenzione: Questa sezione fa riferimento ad una piattaforma considerata deprecata. Nuove funzionalità verranno implementate esclusivamente su v2.smsviainternet.it.
È consigliato usare la versione 2
POST https://v1.smsviainternet.it/post/send.php
POST https://v1.web-servizi.net/post/NOMERIVENDITORE/send.php
Variabili
| Nome variabile | Note |
|---|---|
| smsUSER | username di accesso |
| smsPASSWORD (alias smsPSW) | password di accesso |
| smsSENDTO (alias smsDATE) | data di invio, timezone Europe/Rome, formato "AAAA-MM-GG oo:mm". Esempio "2022-07-04 15:00" |
| smsNUMBER | destinatario singolo |
| smsNUMBERS | destinatari multipli, rimpiazza smsNUMBER. (Numeri separati da virgola, esempio: "+393801234567,+393809876543" |
| smsNUMBERSFROMADDRESSBOOK | se impostato viene ignorato smsNUMBER e smsNUMBERS.Il formato è: G-{idGruppo} (esempio G-1 per inviare ad un singolo gruppo con id 1) C-{idContatto} (esempio C-1 per inviare a singolo contatto. Per dettagli vedi api addressbook |
| smsGATEWAY | Gateway di invio, default 0 (vedi lista gateway) |
| smsRESPONSE-HTML (deprecata) | usare returnTYPE. Se impostato a 1 equivale a returnTYPE=HTML |
| returnTYPE | Valori possibili: HTML, TEXT (default) e JSON. Indica il formato della risposta. |
Esempio
Richiesta
//Ovviamente i controlli sono stati omessi
$queryString = array();
foreach($_POST AS $key => $value) {
$queryString[] = $key . '=' . encodeURL(mb_convert_encoding($value, 'UTF-8', 'ISO-8859- 15')); //converto in UTF-8
}
$queryString = implode('&', $queryString);
$fp = fsockopen(HOST, PORT, $errNo, $errStr, 30); //Vanno fatti i dovuti controlli
fputs($fp, "POST /send/post.php HTTP/1.0\r\n"); fputs($fp, "Host: " . HOST . "\r\n");
fputs($fp, "User-Agent: PHP/" . phpversion() . "\r\n");
fputs($fp, "Content-Type:application/x-www-form-urlencoded; charset=UTF-8\r\n"); fputs($fp, "Content-Length: ".strlen($queryString)."\r\n");
fputs($fp, "Accept-Language: it\r\n");
fputs($fp, "Cache-Control: no-cache\r\n");
fputs($fp, "Connection: close\r\n");
fputs($fp, "\r\n" . $queryString);
note
La codifica che dev’essere utilizzata nella trasmissione dei dati è UTF-8 • In caso si utilizzi un form per la spedizione dei dati tramite POST occorre specificare il charset (in rosso)
Se invece vengono inviati tramite php o altri linguaggi (usando CURL o socket) bisogna impostare la giusta codifica. esempio di invio dati tramite php e socket richiede la presenza del modulo mb (multibyte di php) - funzioni mb_ In questo esempio si parte dal presupposto che la codifica interna sia ISO-8859-15 (standard italiano) encodeURL è una funzione, non inclusa in questo esempio, che trasforma i caratteri speciali nel formato corretto, esempio: € in %80..etc..