Estrutura de Dados & API
Existem 3 formas de se ligar à nossa API:
- Através do Zapier - https://help.drimify.com/pt/article/integracao-com-o-zapier-pidoat/
- Através do Make - https://help.drimify.com/pt/article/integracao-com-makecom-dmxzv0/
- Através de chamadas diretas à API - documentação e exemplo disponíveis aqui: https://endpoint.drimify.com/api/docs?ui=re_doc
O que a API devolve
A API devolve um registo por participação: os campos do formulário, o resultado (pontuação, perfil ou prémio) e os campos técnicos, conforme indicado na tabela abaixo. Não devolve as respostas que cada jogador deu às perguntas de um quiz ou de uma pesquisa. Para consultar cada resposta, utilize a exportação de dados da sua aplicação, onde cada pergunta tem a sua própria coluna.
Estrutura dos dados da API
Veja como pode preencher a coluna Exemplo de dados, com base nos formatos habitualmente utilizados para estes tipos de campos:
Chave | Descrição | Exemplo de dados |
|---|---|---|
Id | Identificador único. |
|
appId | Identificador da aplicação. |
|
appRef | Referência interna da aplicação. |
|
idunic | Dados recolhidos no campo de identificador único. |
|
gender | Dados recolhidos no campo de género. |
|
username | Dados recolhidos no campo de nome de utilizador. |
|
firstName | Dados recolhidos no campo de nome próprio. |
|
lastName | Dados recolhidos no campo de apelido. |
|
Dados recolhidos no campo de e-mail. | ||
dob | Dados recolhidos no campo de data de nascimento. |
|
address | Dados recolhidos no campo de morada. |
|
cp | Dados recolhidos no campo de código postal. |
|
town | Dados recolhidos no campo de cidade. |
|
country | Dados recolhidos no campo de país. |
|
phoneNumber | Dados recolhidos no campo de número de telefone. | |
companyName | Dados recolhidos no campo de nome da empresa. |
|
website | Dados recolhidos no campo de site. | |
optinNewsletter | Dados recolhidos através da caixa de seleção de consentimento. |
|
customText | Dados recolhidos no campo de texto personalizado. |
|
customFormat | Dados recolhidos no campo de formato personalizado. |
|
profil | Perfil obtido numa aplicação de teste de personalidade, quiz ou pesquisa. |
|
profilUid | Identificador único do perfil obtido numa aplicação de teste de personalidade, quiz ou pesquisa. |
|
score | Pontuação do utilizador numa aplicação baseada em pontos. |
|
prizeUid | Identificador único do prémio. Se não tiver sido ganho nenhum prémio, devolve "lost". |
|
prizeTitle | Título do prémio registado quando o utilizador ganha um prémio. |
|
prizeRef | Referência do prémio registada quando o utilizador ganha um prémio. |
|
code | Código ganho pelo utilizador. |
|
date | Data e hora do servidor. |
|
publisherId | Identificador do editor. |
|
sessionId | Identificador da sessão do utilizador. |
|
countryCode | Código do país determinado a partir do endereço IP do utilizador. |
|
selectValue | Dados recolhidos no menu pendente personalizado. |
|
selectValue2 | Dados recolhidos no segundo menu pendente personalizado. |
|
customCheckbox | Dados recolhidos na lista personalizada de caixas de seleção. Se forem selecionadas várias opções, os valores são separados por uma barra vertical. ( |
|
timeTaken | Tempo que o utilizador passou na aplicação, em segundos. |
|
levelsPlayed | Número total de níveis concluídos pelo utilizador nas experiências Combo™, Percurso Dinâmico™ ou Calendário De Advento. Devolve null para todos os outros tipos de jogos. |
|
referral | Origem do tráfego de referência. |
|
updatedAt | Data e hora da atualização dos dados. |
|
connectionCountry | País determinado a partir do endereço IP do utilizador. |
|
updatedAtTimeStamp | Marca temporal da atualização dos dados. |
|
dateWithTimezone | Data e hora convertidas para o fuso horário da aplicação. |
|
played | Indicador que devolve |
|
locale | Idioma da aplicação utilizado durante a experiência do utilizador. |
|
ipAddress | Endereço IP do utilizador. |
|
Actualizado em: 19/10/2026
Obrigado!