---
name: valider-api-avant-integration
description: Passer d'une API prometteuse à une décision d'intégration documentée et testée.
category: Création
difficulty: Intermédiaire
duration: ~1 h
tools: [MCP Freudix, Context7, developpeur, Postman]
---

# Valider une API avant intégration

> Passer d'une API prometteuse à une décision d'intégration documentée et testée.

Une API séduisante sur le papier peut échouer sur les limites de quota, l'authentification, la qualité des réponses ou le coût réel. Avant de l'intégrer à un produit, ce workflow vérifie d'abord l'adéquation au besoin dans le catalogue Freudix, confronte la documentation à jour, construit un prototype d'appel isolé, teste les scénarios normaux et d'erreur, puis consigne une recommandation d'adoption et les garde-fous nécessaires. La décision d'intégrer repose ainsi sur un essai reproductible plutôt que sur une simple fiche commerciale.

## Étapes du workflow

### 1. Besoin produit précis _(Démarrage)_
Un cas d'usage, un volume attendu, un budget et les contraintes de données à couvrir.

### 2. Présélectionner les candidates, MCP `MCP Freudix`
Compare les APIs disponibles par domaine, données exposées et modalités d'accès pour retenir les candidates pertinentes.

### 3. Vérifier la documentation, MCP `Context7`
Récupère les références à jour : authentification, endpoints, formats de réponse, quotas et exemples d'intégration.

### 4. Construire un prototype isolé, Agent `developpeur`
Écrit un client minimal avec variables d'environnement, validation de schéma et gestion explicite des erreurs et timeouts.

### 5. Tester les cas réels et limites, MCP `Postman`
Exécute les requêtes de référence, erreurs d'authentification, limites de quota et réponses incomplètes, puis conserve la collection de test.

### 6. Décider et cadrer l'intégration, Action ``
Documente la décision go/no-go, le coût estimé, les limites acceptées et les métriques à surveiller après mise en service.

### 7. Décision d'intégration étayée _(Résultat)_
Une API validée ou écartée sur preuve, avec un prototype reproductible et des garde-fous clairs pour la suite.

## Comment l'exécuter

Donne ce fichier à Claude Code (ou à ton agent) et demande : « Exécute ce
workflow ». L'assistant enchaînera les Skills / Agents listés dans l'ordre,
en te demandant de valider les étapes sensibles (déploiement, soumission GSC).
Les étapes sur une même ligne du schéma se font en parallèle.

Tu peux aussi adapter chaque étape : remplacer un outil, en sauter une, ou
brancher tes propres Skills.

---
Workflow généré depuis Freudix Studio, https://freudix.studio/workflows/valider-api-avant-integration