Apprenez à utiliser l'API Revizto : remplacez les exportations manuelles par un accès direct et automatisé

Les exportations manuelles créent un décalage entre ce qui se passe réellement sur un projet et ce que les équipes peuvent voir, puisque quelqu'un doit penser à lancer le rapport avant que qui que ce soit puisse agir. Passer de l'exportation manuelle à un accès direct par API permet aux systèmes de récupérer à la demande les données d'annotations, de projets et de modèles, et d'automatiser le travail répétitif de gestion de ces données sur des dizaines de projets à la fois. Un accès direct et en temps réel signifie que les équipes construisent les tableaux de bord et les flux de travail dont elles ont besoin, sans dépendre du calendrier d'exportation de quelqu'un d'autre.

Qu'est-ce qu'une API ?

API signifie application programming interface, soit interface de programmation d'application : une façon de communiquer avec un logiciel sans passer par son interface utilisateur habituelle. Plutôt que de cliquer d'écran en écran, un système peut demander exactement les données dont il a besoin et les recevoir directement.

L'image la plus parlante est celle d'un restaurant. Le client — celui qui construit à partir des données — est le convive. Le serveur Revizto est la cuisine. L'API, au milieu, est le serveur de salle : il porte les commandes en cuisine et rapporte les plats à table. Une requête fonctionne comme un plat à la carte : précise et structurée. La réponse, c'est le plat qui arrive.

Quels sont les deux principaux types de requêtes API ?

Une requête GET récupère quelque chose qui existe déjà, par exemple la liste des licences utilisateurs. Une requête POST ajoute quelque chose de nouveau, par exemple la création d'une annotation dans le suivi des annotations.

Ce que l'API permet aujourd'hui

Cette structure — GET pour récupérer, POST pour ajouter — est ce qui rend possibles les opérations en masse et les intégrations, à la place d'un travail manuel au cas par cas. Les principaux points de terminaison (endpoints) couvrent ce que la plupart des équipes utilisent déjà au quotidien :

• Licences et informations de projet — qui a accès à quoi, et sur quels projets
• Rôles et utilisateurs — toutes les personnes impliquées dans un projet et ce qu'elles sont autorisées à faire
• Flux de travail, états, types d'annotations et modèles de tampons — le cadre dans lequel les annotations sont suivies
• Annotations, commentaires, feuilles 2D et rapports — les données de projet du quotidien

Cela suffit déjà à automatiser deux tâches que les équipes font sans cesse à la main : modifier des milliers d'annotations en une seule fois au lieu de les ouvrir une par une, et gérer l'inscription des utilisateurs sur plusieurs projets depuis un processus unique plutôt que projet par projet.

C'est aussi ainsi que Revizto se connecte à d'autres logiciels. Des outils tiers comme Cupix et OpenSpace, des tableurs, des plateformes SIG et d'autres applications BIM peuvent puiser directement dans ces mêmes données via l'API, sans ressaisie manuelle.

Nouveauté : l'accès aux modèles et au niveau des objets

Les données de modèles, d'éléments et de conflits figuraient jusqu'ici sur la feuille de route plutôt que dans l'API elle-même. C'est terminé. Les métadonnées au niveau de l'objet — degrés de résistance au feu, spécifications des matériaux, types de systèmes et quantités — sont désormais interrogeables directement, sans ouvrir l'application Revizto. Ces données peuvent alimenter des outils d'estimation des coûts, des tableaux de bord d'avancement ou des systèmes de facility management sans que personne n'ait à extraire un rapport au préalable.

Les données d'annotations et de conflits sont maintenant livrées avec tout leur contexte : état, priorité et historique de résolution, regroupements de conflits préservés, et coordonnées spatiales exactes de chaque annotation. Les annotations peuvent être créées directement à partir de photos géolocalisées, importées en masse depuis un CSV ou synchronisées automatiquement avec une plateforme externe. Les métadonnées 2D et 3D s'interrogent de la même manière : les outils en aval restent ainsi alignés sur ce qui est réellement publié dans le projet, sans suivi de versions manuel.

La gestion des utilisateurs suit la même logique : les rôles et les accès aux projets peuvent se synchroniser automatiquement avec des systèmes d'identité externes, de sorte que les contrôles d'accès ne s'écartent pas de ce qu'ils devraient être.

Pour les équipes qui produisent déjà leurs rapports dans Power BI, un connecteur dédié donne un accès direct aux annotations, aux conflits et aux données d'équipe, avec des modèles de tableaux de bord prêts à l'emploi comme point de départ, et la possibilité d'écrire des requêtes personnalisées pour aller plus loin, sans avoir à coder d'appels API de zéro.

Conçue pour la façon dont les équipes travaillent déjà

Quelques choix de conception rendent tout cela concret plutôt que théorique :

Prêt à suivre API Essentials ?

Se familiariser avec l'authentification, les requêtes et les principaux points de terminaison est le moyen le plus rapide de commencer à construire.

Commencer API Essentials sur la Revizto Academy → Gratuit, 1 heure 30, sans licence.
Découvrir le cours