Intégration simple par lien HTTPS
L’intégration la plus simple de système tiers dans l’application mobile / web est le lien vers une page web avec le protocole HTTPS.
Fonctionnement dans l’application native mobile (choix paramétré dans le Hub) :
- Ouverture de la page cible directement dans l’application mobile Geolys (adresse cible invisible)
- Ouverture dans un nouvel onglet du navigateur web
Fonctionnement dans l’application web :
- L’ouverture se fait dans une nouvelle fenêtre
- La page cible doit être idéalement accessible sur une url HTTPS
- La page cible doit être « RWD », c’est-à-dire compatible desktop / mobile / tablette pour une expérience optimale
Intégration d'une API tierce
Ce mode nécessite de développer de nouveaux composants.
Widgets
Un widget se place en page d’accueil de l’application mobile et web. L'API tierce est contactée directement depuis ce widget.
Ex : widget d’affichage perturbations
Pages d'application
Une page de l’application est accessible depuis le menu et profite de tout l'espace de l'écran. L'API tierce est directement contactée depuis cette page.
Ex : télécommande virtuelle
Connecteurs métiers
Un connecteur est un composant "invisible" effectuant des tâches en temps réel ou à intervalle régulier en se connectant à un cloud tiers.
Ex : synchronisation de statut d’incidents avec une GMAO
- Le paradigme REST (GET / PUT / POST / DELETE)
- Des échanges de données au format JSON
- Une clé d’API pour s’authentifier sur le service (dans le cas d’API simple ne nécessitant pas d’authentification utilisateur) au format query string ou header HTTP
- Que le CORS soit activé sur le serveur tiers pour permettre de s’interfacer en javascript depuis une page ou un widget de l’application
- De fournir une documentation à jour de l’API et complète
- D’être informé de tout changement (breaking changes sur APIs en production)