1.1. Introduzione
L’API di Simpoll collega il tuo sito a qualsiasi sondaggio Simpoll in diversi modi. Il suo compito principale è inviare i risultati del sondaggio al tuo sito perché tu possa elaborarli.
Con l’API puoi:
- associare i rispondenti ai visitatori del tuo sito;
- sapere quali visitatori hanno completato il sondaggio;
- sapere come è andato un visitatore in un quiz (superato o no);
- ottenere le risposte che un visitatore ha dato nel sondaggio.
1.2. Come funziona
Il flusso è questo:
- Quando inserisci un sondaggio nel tuo sito, puoi passargli qualsiasi parametro aggiuntivo (per esempio l’ID dell’utente);
- L’utente compila il sondaggio nel riquadro di Simpoll;
- Al termine del sondaggio, Simpoll chiama l’URL dei risultati del tuo sito e restituisce i parametri ricevuti da te (se presenti);
- Insieme ai tuoi parametri, Simpoll invia i risultati del sondaggio all’URL dei risultati.
Così, oltre a consegnare i risultati, un sondaggio può fare da “proxy” per qualsiasi tuo dato.
I parametri possono essere inviati all’URL dei risultati in uno di tre modi:
Metodo POST
I dati vengono inviati in background, senza che l’utente li veda e senza passare dal suo browser. La richiesta parte quando l’utente fa clic su “Invia” nell’ultima pagina del sondaggio.
Metodo GET
Il browser dell’utente viene reindirizzato dall’ultima pagina del sondaggio all’URL dei risultati, con i dati aggiunti come parametri GET. In questa modalità l’impostazione “Reindirizzamento dopo il sondaggio” viene ignorata.
Chiamata di una funzione JavaScript nella tua pagina
I tuoi parametri e i risultati del sondaggio vengono passati a una funzione JavaScript della pagina in cui è inserito il sondaggio. La funzione ha un nome fisso e un argomento: un oggetto con i tuoi parametri e i risultati del sondaggio.
Questo metodo funziona in tutti i browser moderni.
1.3. Sicurezza della trasmissione dei dati
L’API di Simpoll può firmare i dati che riceve e invia. Le firme sono facoltative, ma garantiscono che nessuno modifichi i dati lungo il percorso.