L'API d’Harnest permet de réaliser programmatiquement un certain nombre d'actions et ouvre ainsi différentes possibilités :
Précharger des données dans un nouveau domaine
Créer ou mettre à jour des informations d’Harnest à partir de données venant d'autres systèmes
Exporter des données des rapports vers d'autres applications
Afin de pouvoir utiliser l'API, chaque "appel" devra être accompagné d'un "token" (Bearer) qui permettra de s'assurer que l'action est effectuée par un "utilisateur" autorisé.
Ces tokens doivent être générés depuis l'application neosigna et plus particulièrement la vue Identifiants API.
💡Seuls les utilisateurs avec la permission "Identifiants API" peuvent accéder à la vue.
Pourquoi générer plusieurs identifiants ?
En théorie, un même identifiant peut être utilisé par plusieurs applications interagissant avec Harnest. Il est toutefois recommandé de générer plusieurs identifiants (notamment si vous devez en communiquer à un sous-traitant par exemple) afin de mieux contrôler les flux actifs entre Harnest et d'autres systèmes.
Créer un nouvel identifiant API
Cliquer sur le bouton “+ CRÉER IDENTIFIANT” permet de créer un nouvel identifiant :
💡 Le nom associé à l'identifiant doit permettre de retrouver rapidement où est utilisé le token associé à l'identifiant.
Une fois le nom validé, le token généré pour le nouvel identifiant sera affiché et prêt à être copié.
‼️ Pour des raisons de sécurité, il ne sera pas possible de relire le token après avoir fermé cette modale.
Gérer un identifiant dans le temps
Par défaut, le token associé à un identifiant API est valable 6 mois à compter de sa création. A l'issue de ces 6 mois, il faudra "rafraîchir" l'identifiant pour qu'un nouveau token soit généré.
Si l'utilisation d'un identifiant doit être stoppée, Révoquer l'identifiant en question suspend immédiatement les appels API utilisant le token correspondant.