C'est parti

Il est possible d'intégrer Survio avec des systèmes internes via l'interface API. Voici un manuel succinct qui va vous aider à commencer.

Attention : L'accès à API n'est disponible que pour les clients Survio PRO.  

Survio propose une interface API pour la lecture automatique des données issues de sources différentes. Ces données peuvent être utilisées pour une analyse ultérieure ou pour la mise en place de certains processus. Vous pouvez par exemple envoyer une enquête de satisfaction aux clients et demander à Survio d'automatiquement transférer leurs réponses à CRM ou à n'importe quel outil BI afin de pouvoir continuer à suivre et analyser ces données. Cela permet à la direction de l'entreprise de prendre des mesures rapides et adaptées ou de mieux planifier à long terme.

 Survio API suit les normes Open API et ce schéma peut également être téléchargé.


Sources

L'interface API propose actuellement un accès à une seule source - les réponses individuelles.


Utilisation de l'interface API


Le demande d'interface API se fait avec le protocole HTTP sur l'hôte "https://api2.survio.com/v2/".

La lecture des données nécessite cependant l'obtention des données de connexion. Pour exécuter les demandes, vous avez besoin d'une autorisation qui se fait via le token API. Ce token s'envoie dans l'en-tête HTTP Le format de ce type d'en-tête est le suivant :

Authorization: Bearer <token>

Un exemple de demande de réponses sera ainsi tel que suit :

Example request

Le token est généré spécialement pour votre compte et vous pouvez ainsi avoir accès uniquement aux données dans le cadre de votre compte. Le token n'a pas de date d'expiration, mais il peut être supprimé sur demande.

Pour générer un token, veuillez prendre contact avec notre centre d'aide. 

Toute personne ayant un token peut accéder aux données de votre compte via l'interface API en mode de lecture seulement. Bien qu'il ne soit pas possible d'effacer ou autrement endommager les données, nous vous recommandons de conserver votre token en toute sécurité pour que personne ne puisse en abuser. Le token actuel peut être désactivé à tout moment et un nouveau peut être généré en cas de besoin.

Vous trouverez de plus amples informations sur les différentes caractéristiques des API dans les références

Chaque source contient une adresse URL, une méthode de demande, un schéma de demande et un schéma de réponses.

Numérotation des pages et filtres


Chaque source qui contient une liste des enregistrements propose un maximum de 30 résultats par demande. Les résultats sont triés par ordre décroissant depuis le plus récent. Si vous dépassez la limite de 30 résultats, vous pouvez utiliser le paramètre GET :


?page=<page number> 

à l'aide duquel vous affichez les différentes pages avec les résultats suivants.

La numérotation des pages commence par le numéro "0".

“?page=0” affiche la première page, 

“?page=1” affiche la deuxième page,, 

“?page=2” affiche la troisième page etc. jusqu'à ce qu'il n'y ait plus d'autres résultats à afficher.

Chaque source permet aussi d'utiliser différents filtres pour saisir les résultats. Vous pouvez choisir parmi les possibilités suivantes :

  • date → filtre les résultats selon une date concrète
  • de - à → filtre les résultats selon un intervalle de temps prédéfini
  • temps d'achèvement → filtre les résultats selon le temps nécessaire pour finir le sondage

Vous pouvez par exemple obtenir la liste des réponses reçues après une date concrète à l'aide du format suivant :

?submitted[after]=<time>

Il est également possible d'enchaîner les filtres et de régler par exemple un intervalle de temps concret :

?submitted[after]=<time>&submitted[before]=<time>


Limites d'appel
Le principal objectif des limites d'appel est d'assurer le bon fonctionnement des API, une accessibilité constante aux données et la prévention de tout abus d'utilisation pour que vous ayez toujours toutes les informations nécessaires à disposition. Ces limites concernent uniquement une quantité de 1000 demandes HTTP par heure et par utilisateur. 






EE