Recevoir les résultats

3.1. Recevoir les résultats par POST ou GET

Pour recevoir les résultats dans votre script :

1. activez l’API dans les réglages du sondage ;
2. choisissez POST ou GET comme méthode ;
3. saisissez l’URL complète de votre script comme URL de résultats
   (par exemple https://example.org/result.php).

Simpoll envoie alors une requête POST (ou GET) à cette URL chaque fois que quelqu’un termine le sondage.

Exemple de données envoyées :

POST:
(
    [sp_survey_id] => 551
    [sp_survey_key] => aa7ca07e
    [sp_resp] => Array
        (
            [id] => 172693
            [ip_addr] => 127.0.0.1
            [name] => Respondent No.172693
            [time_start] => 2011-12-13 13:23:24
            [time_end] => 2011-12-13 13:23:45
            [time_delta] => 00:00:21
            [quiz_passed] => 0
            [quiz_percent] => 33
            [quiz_correct] => 3
            [quiz_wrong] => 2
        )
    [sp_result] => 1
    [sp_answers] => Array
        (
            [1] => Array
                (
                    [0] => Italy
                )
            [2] => Array
                (
                    [0] => Pyramids
                    [1] => Kremlin
                    [2] => Colosseum
                    [3] => Eiffel Tower
                )
        )
)

3.2. Paramètres

• sp_survey_id — identifiant du sondage dans Simpoll
• sp_survey_key — la clé utilisée dans l’URL du sondage
• sp_resp — informations sur le répondant :
  • id — identifiant du répondant dans Simpoll
  • ip_addr — adresse IP du répondant
  • name — nom du répondant
  • time_start — début du sondage
  • time_end — fin du sondage
  • time_delta — temps passé sur le sondage
  Ces champs ne sont envoyés que pour les quiz :
  • quiz_passed — quiz réussi ou non (1 = oui, 0 = non)
  • quiz_percent — pourcentage de bonnes réponses (0–100)
  • quiz_correct — nombre de bonnes réponses
  • quiz_wrong — nombre de mauvaises réponses
• sp_result — le sondage a été terminé (toujours 1)
• sp_answers — les réponses : les clés sont les numéros des questions, les valeurs sont des tableaux de réponses à chaque question