Developer guide

invio singolo sms in post http

Grazie alle A.P.I. (Application Programming Interface)
di smSend puoi oggi integrare tutte le funzioni del nostro
software all'interno della tua applicazione, software o sito web.

 

Invio singolo SMS in Post HTTP

POST URL: http://app.smsend.it/sms/send.php
 
Parametri autenticazione:
user - Login cliente o rivenditore (visibile all'interno del proprio account "rivenditore")
pass - Password cliente o rivenditore
 
Parametri obbligatori:
rcpt - Numero destinatario nel formato internazionale +XXYYYZZZZZZZ
data - testo del messaggio (massimo 160 caratteri).
sender - Mittente del messaggio (max 11 caratteri alfanumerici o numero +XXYYYZZZZZZZ).
qty - Qualità del messaggio: (ll, l, a, h, n – bassa, media, automatica, alta, notifica).

N.B. Effettuando un POST/GET HTTP, è necessario eseguire un urlencode dei parametri.
Il carattere '+' nel parametro rcpt deve essere codificato in esadecimale '%2b' o in ISO
 
Parametri opzionali:
operation - Tipo di messaggio che si intende spedire:
operation - TEXT = messaggio di testo (default);
operation - WAPPUSH = messaggio WapPush;
operation - UCS2 = messaggio con codifica UCS2 (massimo 70 caratteri a 16 bit);
operation - MULTITEXT = messaggio concatenato (massimo 918 caratteri);
operation - MULTIUCS2 = messaggio concatenato con codifica UCS2;
I messaggi UCS2, MULTITEXT e MULTIUCS2 possono essere inviati solo in qualità Alta o Notifica (h o n)
url - Indirizzo URL al quale si dovrà collegare il cellulare che riceve il messaggio WAPPUSH.
return_id - Se impostato uguale a 1 verrà restituito l’identificativo della spedizione da utilizzare nel caso si richieda lo stato della spedizione tramite post/get http (es. HTTP00000000111).
 
In caso di successo il server risponderà con "OK <costo>", ove <costo> è il credito scalato per l'invio del messaggio.
 
In caso di errore la risposta del server sarà "KO <testo_errore>".
 
Codici errore:

KO Accesso non consentito (utente non abilitato).
KO Accesso non consentito (IP non abilitato).
KO Parametro <nome_parametro> non impostato.
KO Parametro <nome_parametro> non valido.
KO Il parametro <nome_parametro> può contenere al massimo <n> caratteri.
KO Operatore sconosciuto.
KO Credito insufficiente.
KO Impossibile accodare il/i messaggio/i.
Esempio con parametri obbligatori:
http://app.smsend.it/sms/send.php?user=demo_user&pass=user_demo&rcpt=%2b393391234567&data=testo-del-messaggio&sender=Mittente&qty=h
Esempio con parametri obbligatori e opzionali:
http://app.smsend.it/sms/send.php?user=demo_user&pass=user_demo&rcpt=%2b393391234567&data=testo-del-messaggio&sender=Mittente&qty=h&operation=text
N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.
N.B. Devi avere un account smSend.


Github - Social codingRepository delle A.P.I. smSend su Github

Contribuisci e crea anche tu progetti unici con il repository delle A.P.I. smSend su Github - social coding - http://github/smsend