API iNode

L'API iNode vous permet d'accéder de façon programmatique à vos données de circulation, à vos appareils et à vos liens. Cette page couvre tout ce dont vous avez besoin pour démarrer - de l'authentification de vos requêtes à l'exécution d'exemples complets d'API dans plusieurs langages. Que vous intégriez iNode dans un système existant ou que vous construisiez un flux de travail personnalisé, les sections ci-dessous vous guideront à travers la configuration, étape par étape.

Authentification

iNode prend en charge deux méthodes d'authentification : OAuth2 et API Key. Choisissez la méthode qui convient le mieux à votre configuration. OAuth2 est recommandé pour les applications qui nécessitent des capacités de renouvellement de jeton, tandis que la méthode API Key est plus simple et idéale pour des intégrations rapides.

OAuth2

Pour utiliser OAuth2, contactez l'équipe de soutien de SMATS pour recevoir votre client_id et votre client_secret, qui seront liés à votre compte.

Une fois ces identifiants en main, vous pouvez utiliser le nom d'utilisateur et le mot de passe du compte propriétaire de votre entreprise, ainsi que le client_id et le client_secret, pour récupérer un jeton d'accès.

Construisez le corps d'authentification comme illustré ci-dessous. Notez que le type de contenu doit être défini sur application/x-www-form-urlencoded.

API Key

La méthode API Key est le moyen le plus simple d'accéder à l'API iNode. Pour récupérer votre clé, accédez à Settings > My Profile > API Access dans le tableau de bord iNode et copiez la clé qui s'y trouve.

Seuls les utilisateurs iNode ayant le rôle Owner peuvent accéder à la clé API depuis le tableau de bord.

Une fois votre clé API en main, incluez-la dans l'en-tête Authorization de chaque requête que vous envoyez à l'API iNode, comme illustré dans les exemples ci-dessous. Les exemples ci-dessous effectuent une requête GET vers le point de terminaison iNode v1 pour récupérer les liens.

Exemple d'API

Les exemples Python suivants montrent comment effectuer des appels API authentifiés pour récupérer vos liens et vos appareils. Deux versions sont fournies - une pour chaque méthode d'authentification. Les deux exemples récupèrent la liste complète des liens et des appareils toutes les minutes, en boucle.

Authentification OAuth2

Utilisez cet exemple si vous vous êtes authentifié à l'aide de la méthode OAuth2. Il inclut la logique pour renouveler automatiquement votre jeton d'accès lorsqu'il expire (après 5 jours).

Commencez par définir vos identifiants et les URL des points de terminaison :

Le type de contenu doit être application/x-www-form-urlencoded.

Ensuite, authentifiez-vous et conservez vos jetons. La fonction get_new_token gère le renouvellement lorsque le jeton d'accès expire :

Une fois l'authentification configurée, la boucle ci-dessous récupère vos liens et vos appareils toutes les 60 secondes. Si le jeton a expiré (réponse 401), il se renouvelle automatiquement avant de poursuivre :

Authentification par clé API

Si vous avez récupéré votre clé API depuis iNode > Settings > Profile > API Access (Owner uniquement), utilisez l'exemple suivant à la place. Cette approche est plus simple - aucune gestion de jeton n'est requise.

Configurez les URL de vos points de terminaison et incluez votre clé API dans l'en-tête :

Exécutez ensuite la boucle pour récupérer vos liens et vos appareils toutes les 60 secondes :

Documentation Swagger

La documentation complète de référence de l'API d'iNode est disponible via la documentation Swagger.

Vous devez être connecté à iNode pour accéder à la documentation Swagger.