Developer guide

Creazione clienti 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.

 

Creazione clienti in Post HTTP

POST URL: http://app.smsend.it/backoffice/client‐add.php
 
Parametri autenticazione:
smsusername - Login rivenditore (visibile all'interno del proprio account "rivenditore")
smspassword - Password rivenditore
 
Parametri obbligatori:
name - Nome del cliente da creare
username - Username per l'accesso al pannello
password - Password per l'accesso al pannello
 
Parametri opzionali:
email - E-mail del cliente
tpl_id - Identificativo univoco del profilo assegnato
contact - Campo libero "Contatto"
ref_id - Campo libero "Riferimento"
reseller - Può essere impostato a 0 (cliente) o 1 (rivenditore (default)
vhost - Dominio associato al rivenditore, sul quale dovranno loggarsi gli eventuali clienti
 
In caso di successo il server risponderà con "OK <id>", ove <id> è l'identificativo numerico assegnato al nuovo cliente.
 
In caso di errore la risposta del server sarà "KO <testo_errore>".
 
Codici errore:

KO Accesso non consentito.
KO Username o password errati.
KO Parametri non corretti.
KO Parametro name non impostato.
KO Parametro username non impostato.
KO Parametro password non impostato
KO Impossibile creare un rivenditore.
KO Profilo non corretto.
KO Username già esistente.
KO Errore nella creazione.
Esempio con parametri obbligatori:
http://app.smsend.it/backoffice/client-add.php?smsusername=demo&smspassword=demo&name=cliente&username=demo1&password=demopass
Esempio con parametri obbligatori e opzionali:
http://app.smsend.it/backoffice/client-add.php?smsusername=demo&smspassword=demo&name=cliente&username=demo1&password=demopass&email=demo@demo.it&tpl_id=0&contact=0612345678&ref_id=utentedemo&reseller=0&vhost=inviasms.nomesito.it
N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.
N.B. Devi avere un account smSend.