Passer d’un produit utilisable à une plateforme automatisable

Le besoin initial

taap.it disposait déjà d’un produit fonctionnel. Ses utilisateurs pouvaient créer et gérer leurs ressources depuis l’application.

Cependant, les clients et partenaires ne disposaient pas d’une API publique complète leur permettant de :

• intégrer taap.it dans leurs propres applications ;
• automatiser la création et la gestion de ressources ;
• connecter leurs workflows internes ;
• construire des outils spécialisés au-dessus de la plateforme.

En parallèle, l’application mobile et l’extension de navigateur avaient également besoin d’une base commune pour communiquer avec le produit.

Une API comme couche d’automatisation

Nous avons conçu et développé une architecture d’API couvrant les principales capacités du produit :

• authentification et gestion des accès ;
• espaces de travail et projets ;
• liens, domaines et pages ;
• statistiques et données d’utilisation ;
• permissions et contrôles de sécurité ;
• opérations destinées aux applications internes ;
• opérations publiques destinées aux clients et partenaires.

L’objectif n’était pas simplement de rendre des données accessibles. Chaque opération devait respecter les mêmes règles métier que le produit principal, renvoyer des réponses cohérentes et empêcher un utilisateur d’accéder aux ressources d’un autre espace de travail.

Une base commune pour tout l’écosystème

La nouvelle API est devenue la fondation partagée de plusieurs usages.

L’application mobile et l’extension de navigateur utilisent une interface interne adaptée à leurs besoins. Les clients et partenaires disposent, de leur côté, d’une API publique leur permettant de construire leurs propres automatisations.

Cette séparation permet de faire évoluer les applications internes sans exposer leurs contraintes aux intégrateurs externes, tout en maintenant des règles communes pour l’authentification, les permissions et les opérations métier.

Rendre l’automatisation réellement accessible

Une API non documentée reste réservée aux personnes qui connaissent déjà le système.

Nous avons donc également construit et maintenu le portail de documentation développeur de taap.it. Celui-ci rassemble :

• les procédures de démarrage ;
• les méthodes d’authentification ;
• les références des opérations disponibles ;
• des exemples d’utilisation ;
• des parcours d’intégration dans plusieurs langues.

La documentation fait partie du produit : elle réduit la dépendance à l’équipe interne et permet aux clients de passer plus rapidement de l’idée à une intégration fonctionnelle.

L’impact

La mission a permis à taap.it de disposer :

• d’une base commune pour son application mobile et son extension ;
• d’une API publique pour les clients et partenaires ;
• d’accès et permissions mieux contrôlés ;
• d’une expérience d’intégration plus claire ;
• d’une plateforme capable d’être intégrée dans des workflows qui dépassent son interface native.

taap.it ne fournit ainsi plus uniquement un produit à utiliser. Il fournit aussi des briques que ses clients peuvent intégrer à leurs propres systèmes.

Ce que ce projet démontre

Ce cas illustre une autre forme d’automatisation : donner à une entreprise et à ses clients une couche d’intégration stable pour relier les produits, déclencher des actions et supprimer des manipulations répétitives.

Nous concevons les API comme des produits opérationnels complets, avec leurs utilisateurs, leurs règles, leur sécurité et leur parcours d’adoption.