...
Xmlsubscribe.aspx (User subscription)
Questa funzione è analoga alla precedente, le principali differenze consistono nel formato con cui si specificano i parametri e nal fatto che la xmlSubscribe restituisce un codice di ritorno con informazioni sull'esito dell'operazione.
Per creare un form che iscrive a più liste contemporaneamente, inviando una sola email di richiesta conferma, utilizzare l'API subscribe.aspx descritta nel precedente paragrafo.
URL: http://newsletter.nomedominio.tld/frontend/xmlSubscribe.aspx (sostituire la parte in rosso con il dominio di terzo livello corretto)
(OBBL. = Obbligatorio)
PARAMETRI IN INGRESSO:
NOME | OBBLIGATORIO. | DESCRIZIONE |
NO (1) | Indirizzo e-mail dell'utente | |
Sms | NO (1) | Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2) |
List | SI | Lista di distribuzione |
Group | NO | I gruppi nei quali iscrivere l'utente |
Confirm | NO | parametro per abilitare o meno l'email di richiesta confermaValori accettati: 0/1 e di default: 1 |
csvFldNames | NO | codici dei campi anagrafici (separati da |
csvFldValues | NO | valori corrispondenti ai codici dei campi anagrafici (separati da |
retCode | NO | Parametro per abilitare o meno la restituizione del codice di ritorno della chiamataValori accettati: 0/1 – Valore di default: 0 |
Dynsndmail(3) | NO | "dynamic sender e-mail address" Indirizzo e-mail del mittente nell'e-mail di richiesta conferma (se non specificato viene usato il valore di default specificato per la lista) |
dynsndname(3) | NO | "dynamic sender name" Nome del mittente nell'e-mail di richiesta conferma (se non specificato viene usato il valore di default specificato per la lista) |
(1) deve essere specificato almeno uno dei parametri email e sms
(2) se non specificato verrà utilizzato il prefisso internazionale italiano (0039)
(3) per ulteriori dettagli sull'utilizzo di questi campi consultare la descrizione dei campi omonimi per la pagina subscribe.aspx
VALORI RESTITUITI
CODICE | DESCRIZIONE |
0 | Operazione completata con successo |
1 | Errore generico |
2 | Indirizzo email/numero cellulare non valido |
3 | Utente già iscritto |
Nota: per conoscere il dominio di terzo livello utilizzato è sufficiente entrare in MailUp e guardare l'indirizzo della propria console. Ad esempio in figura sotto tale dominio è "v73.s02.it"
Figura 13: indicazione del dominio di terzo livello per una certa console