3.1. Receber resultados por POST ou GET
Para receber os resultados no seu script:
- ative a API nas configurações da pesquisa;
- escolha POST ou GET como método;
- informe a URL completa do seu script como URL de resultados
(por exemplo, https://example.org/result.php).
A partir daí, o Simpoll envia uma requisição POST (ou GET) para essa URL toda vez que alguém conclui a pesquisa.
Exemplo dos dados enviados:
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. Parâmetros
- sp_survey_id — ID da pesquisa no Simpoll
- sp_survey_key — a chave usada na URL da pesquisa
- sp_resp — informações sobre o respondente:
- id — ID do respondente no Simpoll
- ip_addr — endereço IP do respondente
- name — nome do respondente
- time_start — quando a pesquisa foi iniciada
- time_end — quando a pesquisa foi concluída
- time_delta — tempo gasto na pesquisa
Estes campos são enviados apenas em quizzes:- quiz_passed — se o quiz foi aprovado (1 = sim, 0 = não)
- quiz_percent — porcentagem de respostas certas (0–100)
- quiz_correct — número de respostas certas
- quiz_wrong — número de respostas erradas
- sp_result — a pesquisa foi concluída (sempre 1)
- sp_answers — as respostas: as chaves são os números das perguntas, e os valores são arrays com as respostas a cada pergunta