Dans le cas où l’application avec laquelle vous souhaitez déclencher Gyrafar n’existe pas encore, il reste une solution : faire une intégration par webhook.
Il est nécessaire que votre application puisse émettre des appels HTTP personnalisés (URL spécifique, en-têtes personnalisés, méthode POST, et potentiellement corps/body de requête adaptable).
Dans le cadre d’une intégration personnalisée (parfois appelée « Custom » dans l’app), il faut d’abord installer l’application via l’application mobile Gyrafar. Cliquez ici pour voir comment installer une application
Une fois l’application Custom ajoutée dans l’application mobile Gyrafar, cliquez dessus et cliquez sur l’icône à droite de « Clé API » pour copier la clé API dans le presse-papiers.
Configuration du côté de votre application
Pour pouvoir déclencher Gyrafar, il faut que votre application puisse faire un appel sur une API avec un format précis :
- URL : https://api.gyrafar.com/gyrafarNotify
- Méthode :
POST - Headers/En-têtes :
Content-type:application/jsonAuthorization: Coller ici la clé API copiée plus tôt
- Corps/Body (optionnel, voir juste en dessous) :
{"data": "Ce que vous désirez"}
Le body/corps en json de la requête est optionnel :
- Si vous souhaitez déclencher Gyrafar à chaque appel d’API, pas besoin de spécifier de corps
- Si vous souhaitez ajouter de la variabilité aux déclenchements, vous pouvez par exemple envoyer
{"data": "vert"}ou{"data": "NewOrder"}pour faire clignoter Gyrafar Multi en vert
Configuration des règles de déclenchement
Retournez ensuite dans l’application mobile Gyrafar pour finir la configuration : Configurer les règles
Dans le cas où vous avez choisi un déclenchement basé sur le body/corps de la requête, vous pouvez implémenter la logique souhaitée via les conditions, par exemple :
- Donnée contient « Nouvelle »
- Donnée est « vert » OU donnée est « green »
Testez ensuite l’intégration via les moyens mis à disposition depuis votre application source.