Tools do SurveyMonkey
As 11 operações do SurveyMonkey que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Listar pesquisasGETLista as pesquisas que a conta possui ou que foram compartilhadas com ela, com id, título e nickname; include adiciona contagens, datas e links. Pagine com page enquanto a resposta tiver links.next.
- Listar pastas de pesquisasGETLista as pastas de pesquisas da conta com id, título e número de pesquisas. Pagine com page enquanto a resposta tiver links.next.
- Obter pesquisaGETRetorna a pesquisa inteira: configurações, os links de edição, prévia, coleta e análise, e cada página com suas perguntas e opções de resposta, todos com seus ids. As ferramentas de respostas e Listar resumos da pesquisa se referem a esses ids.
- Criar pesquisaPOSTCria uma pesquisa: vazia, copiada de outra pesquisa com from_survey_id, ou com suas páginas e perguntas em pages. Retorna o id da pesquisa e seus links de edição, prévia e coleta. Ela ainda precisa de um coletor para receber respostas.
- Atualizar pesquisaPATCHAltera o título, nickname, idioma, textos dos botões, variáveis customizadas, rodapé ou pasta de uma pesquisa. Páginas e perguntas permanecem como estão.
- Listar coletoresGETLista os coletores de uma pesquisa, as formas como ela recebe respostas, como um link web ou um convite por email, com id e nome; include adiciona type, status, url e response_count. Pagine com page enquanto a resposta tiver links.next.
- Criar coletorPOSTCria um coletor para uma pesquisa. Um coletor weblink retorna o link para compartilhar em url, e é o único tipo que o plano gratuito pode criar. Um coletor email só prepara o convite: destinatários e envio ficam no SurveyMonkey.
- Atualizar coletorPATCHAltera um coletor: fecha ou reabre com status, ou muda seu nome, data de encerramento, limite de respostas, mensagens e redirecionamento.
- Listar respostasGETLista as respostas de uma pesquisa com todas as respostas dadas, como ids de pergunta, opção e linha, mais os textos quando simple é true. No plano gratuito só as primeiras 25 respostas de cada pesquisa voltam, e pedir mais retorna o erro 1005. Pagine com page enquanto a resposta tiver links.next.
- Obter respostaGETRetorna uma resposta com todas as respostas dadas, seu status, horários, coletor e os dados do respondente que o coletor guarda.
- Listar resumos da pesquisaGETRetorna o resumo de cada pergunta de uma pesquisa: quantas respostas escolheram cada opção, linha e coluna, com os ids das perguntas de Obter pesquisa.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
