API & Structure des données
Il existe 3 façons de se connecter à notre API :
- Avec Zapier - https://help.drimify.com/fr/article/integration-zapier-118zp6c/
- Avec Make - https://help.drimify.com/fr/article/integration-makecom-92spzn/
- Par des appels directs à l’API - documentation et exemple disponibles ici : https://endpoint.drimify.com/api/docs?ui=re_doc
Données renvoyées par l’API
L’API renvoie un enregistrement par participation : les données des champs du formulaire, le résultat (score, profil ou gain) et les champs techniques, comme indiqué dans le tableau ci-dessous. Elle ne renvoie pas le détail des réponses données par un joueur à chaque question d’un quiz ou d’un sondage. Pour consulter toutes les réponses, utilisez l’export des données de votre application : chaque question y dispose de sa propre colonne.
Structure des données de l’API
Voici comment renseigner la colonne Exemple de données à partir des formats courants pour ces types de champs :
Clé | Description | Exemple de données |
|---|---|---|
Id | Identifiant unique. |
|
appId | Identifiant de l’application. |
|
appRef | Référence interne de l’application. |
|
idunic | Données recueillies dans le champ « Identifiant unique ». |
|
gender | Données recueillies dans le champ « Civilité ». |
|
username | Données recueillies dans le champ « Nom d’utilisateur ». |
|
firstName | Données recueillies dans le champ « Prénom ». |
|
lastName | Données recueillies dans le champ « Nom ». |
|
Données recueillies dans le champ « Adresse e-mail ». | ||
dob | Données recueillies dans le champ « Date de naissance ». |
|
address | Données recueillies dans le champ « Adresse postale ». |
|
cp | Données recueillies dans le champ « Code postal ». |
|
town | Données recueillies dans le champ « Ville ». |
|
country | Données recueillies dans le champ « Pays ». |
|
phoneNumber | Données recueillies dans le champ « Numéro de téléphone ». | |
companyName | Données recueillies dans le champ « Nom de la société ». |
|
website | Données recueillies dans le champ « Adresse du site internet ». | |
optinNewsletter | Données recueillies via la case à cocher de consentement. |
|
customText | Données recueillies dans le champ de texte personnalisé. |
|
customFormat | Données recueillies dans le champ au format personnalisé. |
|
profil | Profil obtenu dans une application de type test de personnalité, quiz ou sondage. |
|
profilUid | Identifiant unique du profil obtenu dans une application de type test de personnalité, quiz ou sondage. |
|
score | Score de l’utilisateur dans une application basée sur un système de points. |
|
prizeUid | Identifiant unique du gain. Si aucun lot n’a été gagné, ce champ renvoie lost. |
|
prizeTitle | Nom du gain enregistré lorsque l’utilisateur remporte un lot. |
|
prizeRef | Référence du gain enregistrée lorsque l’utilisateur remporte un lot. |
|
code | Code remporté par l’utilisateur. |
|
date | Horodatage du serveur. |
|
publisherId | Identifiant de l’éditeur. |
|
sessionId | Identifiant de session de l’utilisateur. |
|
countryCode | Code du pays déterminé à partir de l’adresse IP de l’utilisateur. |
|
selectValue | Données recueillies via le menu déroulant personnalisé. |
|
selectValue2 | Données recueillies via le deuxième menu déroulant personnalisé. |
|
customCheckbox | Données recueillies via la liste personnalisée de cases à cocher. Si plusieurs options sont sélectionnées, les valeurs sont séparées par une barre verticale. ( |
|
timeTaken | Temps passé par l’utilisateur sur l’application, en secondes. |
|
levelsPlayed | Nombre total de niveaux terminés par l’utilisateur dans les expériences Combo™, Parcours Dynamique™ ou Calendrier De L'Avent. Renvoie null pour tous les autres types de jeux. |
|
referral | Référence de la source du trafic. |
|
updatedAt | Date de mise à jour des données. |
|
connectionCountry | Pays déterminé à partir de l’adresse IP de l’utilisateur. |
|
updatedAtTimeStamp | Horodatage de la mise à jour des données. |
|
dateWithTimezone | Horodatage converti dans le fuseau horaire de l’application. |
|
played | Indicateur qui renvoie |
|
locale | Langue de l’application utilisée lors de la participation de l’utilisateur. |
|
ipAddress | Adresse IP de l’utilisateur. |
|
Mis à jour le : 19/10/2026
Merci !