Résumé
L'Interface de Programmation d'Applications MindBridge (« API ») vous permet de contrôler les autorisations et l'accès à divers aspects de votre locataire MindBridge, y compris les bibliothèques, organisations, missions, et analyses.
Avec l'API, vous pouvez transférer en toute sécurité des fichiers de votre ERP directement dans le gestionnaire de fichiers, importer les données dans une analyse, et exécuter l'analyse — le tout depuis l'extérieur de l'application MindBridge. Ensuite, il vous suffit de vous connecter à MindBridge pour voir les résultats de l'analyse.
Détails de configuration
Vous devez être un administrateur de l’application pour accéder à la page de l'API.
Comment puis-je obtenir l'accès à l'API ?
Contactez votre administrateur de l’application pour demander l'accès à l'API MindBridge.
Comment fonctionne une API ?
Une API permet à une application de communiquer avec l'application MindBridge via un ensemble de commandes clairement définies, permettant un accès sécurisé aux actifs et processus d'entreprise en utilisant une interface REST.
Comme illustré dans l'image ci-dessous, utiliser une API est similaire à passer une commande dans un restaurant. Pensez aux commandes API comme à une commande sur un menu de restaurant — le menu définit une liste de "plats" disponibles (comme des programmes ou des fonctions), et lorsque vous passez une commande, la cuisine (comme le serveur ou la base de données) prépare la nourriture (comme la requête) en arrière-plan, puis vous l'envoie lorsqu'elle est prête.
En bref, les API définissent une liste de commandes. Lorsqu'un ERP utilise l'une de ces commandes, MindBridge renvoie ce qui a été demandé.
Qu'est-ce qu'une architecture REST ?
MindBridge utilise une architecture API RESTful, qui permet aux systèmes informatiques d'échanger des informations en toute sécurité sur Internet en utilisant HTTPS. Les requêtes effectuées via une API RESTful sont sans état, et chaque requête contient toutes les données nécessaires pour compléter la requête avec succès.
Quels sont les avantages d'utiliser une API ?
Les API permettent :
- L'ingestion de données évolutive et l'exportation des résultats en utilisant l'automatisation
- Une plateforme d'analyse de données unifiée, quel que soit le secteur ou les besoins de l'organisation
- Un accès sécurisé et contrôlé aux données de MindBridge qui crée de nouvelles opportunités pour des analyses et des insights à grande échelle
- L'automatisation de tâches complexes et répétitives
Qu'est-ce qu'un jeton d'API MindBridge ?
Un jeton d'API MindBridge est une chaîne de caractères qui agit comme une clé pour l'API, et est implémenté comme un jeton d'authentification porteur. Il est utilisé en ajoutant le jeton à l'en-tête de chaque requête HTTPS.
Ce type de jeton est un jeton d'authentification sécurisé cryptographiquement qui inclut les autorisations configurées permettant aux clients API d'accéder aux ressources de l'API MindBridge ou aux "points de terminaison".
Comment utiliser le jeton d'API ?
Pour utiliser un jeton généré au sein de la plateforme MindBridge, vous devez ajouter ce qui suit à l'en-tête de chaque requête HTTPS :
Authorization: Bearer {token} Combien de temps durent les jetons d'API ?
Le cycle de vie du jeton est configurable par l'administrateur de l’application pour toute période de temps, jusqu'à un maximum de 2 ans.
Que se passe-t-il si mon jeton d'API est compromis ?
Les jetons doivent être stockés dans un endroit sécurisé, et ne doivent jamais être partagés. La sécurité de votre jeton est primordiale.
Si un jeton est compromis, l'administrateur de l’application doit désactiver et réémettre le jeton immédiatement.
Qu'est-ce qu'un point de terminaison ?
Les points de terminaison sont des fonctions exposées d'une API d'application avec des fonctionnalités fournies par les méthodes HTTPS.
Qu'est-ce qu'une méthode HTTPS ?
Une méthode HTTPS représente une fonctionnalité prise en charge par le protocole HTTPS, telle que GET, POST, PUT, PATCH, et DELETE.
Ces méthodes vous permettent essentiellement de lire, écrire ou supprimer des bibliothèques, organisations, missions, analyses, utilisateurs, et bien plus encore.
Comment les jetons d'API sont-ils générés ?
Un administrateur de l’application crée des jetons d'API dans la section Admin de l'application, où ils peuvent appliquer le cycle de vie et les autorisations à chaque jeton.
Apprenez comment créer un jeton d'API MindBridge.
Qui peut accéder et utiliser l'API ?
Quiconque possède un jeton valide peut utiliser l'API.
Les administrateurs de l’application sont responsables de la gestion des jetons d'API, et peuvent accorder l'accès à l'API à tout utilisateur au sein de la mission.
Comment utiliser l'API ?
Pour utiliser l'API :
- Un jeton d'API doit être généré par un administrateur de l’application au sein de MindBridge.
- Une fois que vous avez accès au jeton d'API, utilisez le protocole HTTPS pour faire une requête à un point de terminaison documenté dans l'API MindBridge. Les requêtes peuvent être effectuées en utilisant une variété d'outils, y compris la plupart des langages de programmation.
Quel est le format pour communiquer avec l'API ?
L'API utilise JSON pour toutes les requêtes et réponses, à l'exception des fichiers de données, qui peuvent être importés dans n'importe quel format pris en charge par l'application.
Quels formats de fichiers sont acceptés via l'API ?
Tous les formats de fichiers actuellement pris en charge par le gestionnaire de fichiers seront acceptés, tels que .xlsx, .csv, et plus encore.
Quels fichiers puis-je pousser ou tirer via l'API ?
Entrant
Tous les fichiers actuellement pris en charge par la plateforme MindBridge peuvent être poussés via l'API.
Les fichiers peuvent être assignés à n'importe quelle source au sein d'une analyse, comme l'emplacement "Grand Livre".
Sortant
L'API prend en charge les résultats d'analyse paginés, indexés par transactions, ou écritures également. Les données disponibles sont équivalentes au tableau de données dans la plateforme MindBridge.
Où puis-je trouver une documentation plus détaillée ?
Les articles suivants fournissent des détails supplémentaires et des conseils concernant l'API MindBridge.
Pour la documentation technique, ouvrez le menu Actions sur le côté droit de l'onglet API, puis sélectionnez Voir la référence de l'API. Vous serez dirigé vers le document de référence de l'API.
Pour voir une liste continue des modifications apportées à l'API, ouvrez le menu Actions sur le côté droit de l'onglet API, puis sélectionnez Voir le journal des modifications de l'API. Vous serez dirigé vers le journal des modifications de l'API.
Veuillez consulter L'API MindBridge pour plus d'informations sur l'API MindBridge. Vous pouvez également Accéder au support client MindBridge ou Nous contacter.
En tant qu'utilisateur de l'API, par où puis-je commencer ?
- Lisez la documentation de l'API MindBridge
- Générez ou obtenez l'accès à un jeton d'API
- Essayez les points de terminaison et actions API souhaités
Autre chose en tête ? Discutez avec nous ou soumettez une demande pour une assistance supplémentaire.