Scarica gli esempi Scarica il manuale per gli sviluppatori

Gli esempi contengono: Invio SMS singolo, Visualizzazione Credito

API per Webmaster

Tramite le API è possibile effettuare le seguenti operazioni :
- Invia SMS Privato
- Invia SMS a Gruppo
- Invia SMS a Utente
- Visualizzare SMS Inviati
- Visualizzare SMS Ricevuti
- Visualizzare Inbox
- Visualizzare Sandbox
- Visualizzare Credito
- Visualizzare lista Contatti per Nome,Cellulare o Email
- Visualizzare lista Contatti per Gruppo
- Visualizza Token attuale
- Genera nuovo Token

Url base

L'url base da utilizzare per accedere alle API è http://login.smsnet/index.php?app=ws

Autenticazione

Tutte le richieste alle API richiedono l'autenticazione dell'utente tramite due parametri Username e Token.
Username corrisponde al tuo Nome Utente
Token è un codice generato automaticamente da SMSnet

Per generare un nuovo Token seguire questi semplici passi :
- accedere a SMSnet
- entrare nella Configurazione Utente
- spostarsi su "Nuovo token webservice"
- dal menu a tendina impostare Si
- premere Salva

Nella riga "Webservices token" apparirà il vostro token da utilizzare per le richieste API.

Possibili risposte dal Server

Per ogni richiesta le API rispondono con dei codici divisi per categoria.

Categoria Risposte :

ERR 1xx errore di autenticazione o parametri errati
ERR 2xx errore specifico azione
ERR 4xx errore stato di consegna
ERR 5xx altri errori

Codici Risposte :

ERR 100 Autenticazione fallita
ERR 101 Tipo azione non valida o sconosciuta
ERR 102 Uno o piu parametri sono vuoti
ERR 103 Non hai abbastanza credito
ERR 104 Il webservice token non è attivo
ERR 105 Il webservice token non è abilitato dall’utente
ERR 106 Il webservice token non è abilitato per questo IP
ERR 200 Invio SMS fallito
ERR 201 Numero destinatario o messaggio vuoti
ERR 400 Stato consegna non abilitato
ERR 401 Stato consegna non ricevuto e SMS ancora in coda
ERR 402 Stato consegna non ricevuto e SMS in coda processato per l’invio
ERR 501 Nessuna risposta o nessun risultato

VARIABILI

Parametro Descrizione
op Indica l'azione da eseguire
u Il tuo Nome Utente
h Il tuo Token
p Password account, necessario per l'operazione "Visualizza Token"
to Numeri destinatari separati da una virgola
Questo parametro deve essere un numero internazionale valido (Esempio : +39 333 12 34 567)
Questo parametro può contenere @username o #codicegruppo
msg Contenuto del messaggio
I caratteri + o %20 sostituiscono lo spazio.
Utilizzare funzione urlencode per caratteri non ascii
type Tipo messaggio (flash oppure text )
schedule Programma l'invio del messaggio, formato : YYYY-MM-DD hh:mm:ss
from Alias, necessario per l'operazione "Invia SMS"
footer Firma del messaggio
nofooter Rimuove la firma del messaggio
queue Codice coda, reperibile dalla pagina SMS in coda
src Numero mittente o Alias
dst Numero destinatario, un solo nu mero
dt Invia data e ora SMS
smslog_id SMS Log ID
last Ultimo SMS log ID (questo numero non è incluso nei risultati)
c Numero di stato recapito che verrà recuperato
kwd Parola chiave
format Formato SMS, possibili scelte :
json (Json output)
xml (XML output)
serialize (PHP Serialize output)
plain o vuoto (output testo)

ESEMPI

Invio SMS singolo o a gruppo rubrica

Il parametro opzionale 'to' può contenere un numero internazionale, #codicegruppo, @username oppure un misto tra queste tre opzioni inserendo piu valori separati da una virgola.

Parametri Descrizione
Operazione Utilizzare il parametro op=pv
Obbligatori 'u', 'h', 'to', 'msg'
Opzionali 'type', 'unicode', 'from', 'footer', 'nofooter', 'format'
Risultato restituisce un codice errore oppure OK

Ricezione SMS

Il parametro opzionale 'c' recuperarà x risultati in base al suo valore, il parametro 'last' recupererà risultati solo dall'ultimo SMS log ID.

Parametri Descrizione
Operazione Utilizzare il parametro op=ds
Obbligatori 'u', 'h'
Opzionali 'queue', 'src', 'dst', 'dt', 'smslog_id', 'c', 'last', 'format'
Risultato restituisce i valori oppure un codice errore

Inbox SMS

Il parametro opzionale 'c' recuperarà x risultati in base al suo valore, il parametro 'last' recupererà risultati solo dall'ultimo SMS log ID.

Parametri Descrizione
Operazione Utilizzare il parametro op=ix
Obbligatori 'u', 'h'
Opzionali 'queue', 'src', 'dst', 'dt', 'smslog_id', 'c', 'last', 'format'
Risultato restituisce i valori oppure un codice errore

Sandbox SMS

Il parametro opzionale 'c' recuperarà x risultati in base al suo valore, il parametro 'last' recupererà risultati solo dall'ultimo SMS log ID.

Parametri Descrizione
Operazione Utilizzare il parametro op=sx
Obbligatori 'u', 'h'
Opzionali 'queue', 'src', 'dst', 'dt', 'smslog_id', 'c', 'last', 'format'
Risultato restituisce i valori oppure un codice errore

Visualizzare Credito

Parametri Descrizione
Operazione Utilizzare il parametro op=cr
Obbligatori 'u', 'h'
Opzionali 'format'
Risultato restituisce il credito oppure un codice errore

Visualizza Token

Parametri Descrizione
Operazione Utilizzare il parametro op=get_token
Obbligatori 'u', 'h'
Opzionali 'format'
Risultato restituisce il token oppure un codice errore

Genera Token

Parametri Descrizione
Operazione Utilizzare il parametro op=set_token
Obbligatori 'u', 'h'
Opzionali 'format'
Risultato restituisce il nuovo token generato oppure un codice errore

Lista Contatti

Parametri Descrizione
Operazione Utilizzare il parametro op=get_contact
Obbligatori 'u', 'h', 'kwd'
Opzionali 'c', 'format'
Risultato restituisce la lista dei contatti simili o uguali al parametro 'kwd' oppure un codice errore

Lista Contatti in Gruppi

Parametri Descrizione
Operazione Utilizzare il parametro op=get_contact
Obbligatori 'u', 'h', 'kwd'
Opzionali 'c', 'format'
Risultato restituisce la lista dei contatti simili o uguali al parametro 'kwd' oppure un codice errore


Scarica gli esempi Scarica il manuale per gli sviluppatori

Gli esempi contengono: Invio SMS singolo, Visualizzazione Credito


torna su

Registrati per un test gratuito Registrati

In omaggio 30 SMS per testare la piattaforma