Qu’est-ce que Dev Proxy ?

Le proxy de développement est un simulateur d’API qui vous permet de tester facilement votre application au-delà du chemin heureux.

Vous testez votre application pour vous assurer qu’elle fonctionne comme prévu. Mais que se passe-t-il si les API que vous utilisez échouent ? Votre application va-t-elle perdre les données de votre client ? Comment tester cela ? La simulation d’échecs d’API est difficile. Vous finissez par écrire du code que vous ne livrerez pas, ou pire, ne pas le tester du tout. C’est pourquoi nous avons créé le proxy de développement pour simuler des erreurs d’API afin que vous puissiez facilement tester votre application sans modifier votre code.

Avec Dev Proxy, vous :

Le proxy de développement est un outil en ligne de commande qui fonctionne sur n’importe quelle plateforme. Étant donné qu'il intercepte les requêtes réseau, il fonctionne avec n'importe quel type d'application et de pile technologique. Le proxy de développement est code source ouvert et gratuit à utiliser.

À qui s'adresse le proxy de développement ?

Le proxy de développement aide les développeurs qui :

  • Créer des applications qui appellent des API : testez la façon dont votre application gère les erreurs et les limites de débit des API telles que GitHub, OpenAI et Anthropic, sans modifier votre code
  • Créer des applications avec Microsoft Graph - Obtenir des conseils sur les autorisations et les bonnes pratiques
  • API de conception - Prototype et API fictives avant l’implémentation
  • Automatiser les tests - Intégrer des tests de chaos dans des pipelines CI/CD

Quand utiliser le proxy de développement

Utilisez le proxy de développement lorsque vous devez :

  • Tester la résilience des API sans modifier votre code d’application
  • Travaillez avec n’importe quelle stack technologique (navigateur, Node.js, .NET, Python, etc.)
  • Simuler des échecs pour les API que vous ne contrôlez pas
  • Obtenir des conseils sur les meilleures pratiques de Microsoft Graph
  • Automatiser les tests de chaos dans les pipelines CI/CD

Envisagez d’autres approches quand :

  • Vous n'avez besoin que de mock dans le navigateur pour les tests unitaires d'interface.
  • Vous créez l’API et avez besoin de tests contractuels
  • Vous devez modifier les corps de requête/réponse par programmation (le proxy de développement peut le faire, mais les outils dédiés peuvent être plus simples)

Démarrage rapide par scénario

Choisissez votre chemin d’accès en fonction de ce que vous souhaitez accomplir :

Que voulez-vous faire ? Heure Guide
Tester comment mon application gère les erreurs d'API 5 minutes Tester avec des erreurs aléatoires
Vérifier que mon application gère les limites de débit de l’API GitHub Durée : 15 minutes Tester les limites de débit de l’API GitHub
Tester que mon application gère les limites de débit OpenAI 10 min Tester les limites de débit OpenAI
Simuler une API qui n’existe pas encore 10 min Simuler une API CRUD
Vérifier mes autorisations Microsoft Graph 10 min Détecter les autorisations minimales
Comprendre les API que mon application appelle 5 minutes Découvrir les URL à regarder
Automatiser les tests d’API dans CI/CD Durée : 15 minutes Utiliser le proxy de développement dans CI/CD

Résoudre un problème d’API

Vous avez rencontré une erreur d’API, ou vous créez une application ou un agent IA ? Partez du problème :

Essayez-le avec un préréglage

Les préréglages sont des configurations de proxy de développement prêtes à l’utilisation pour des API spécifiques. Pour voir comment votre application gère les limites de débit et les erreurs de l’API qu’elle appelle, commencez par installer Dev Proxy.

winget install DevProxy.DevProxy --silent

Une fois l’installation terminée, ouvrez une nouvelle invite de commandes pour qu’elle prenne en compte le PATH mis à jour.

brew tap dotnet/dev-proxy
brew install dev-proxy
bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Ensuite, téléchargez le préréglage pour votre API.

API Command
GitHub devproxy config get github-rate-limiting
OpenAI devproxy config get openai-throttling
Anthropic devproxy config get anthropic-throttling
Microsoft Graph devproxy config get microsoft-graph-rate-limiting

Démarrez le proxy de développement avec le préréglage. Remplacez github-rate-limiting par le préréglage que vous avez téléchargé. La première fois que vous démarrez Dev Proxy, vous devez faire confiance à son certificat.

devproxy --config-file "~dataFolder/configs/github-rate-limiting/.devproxy/devproxyrc.json"

Exécutez votre application comme d’habitude. Il continue d’appeler les URL réelles de l’API, et Dev Proxy simule les limites de taux et les erreurs de l’API.

Pour connaître les préréglages pour d’autres API, consultez la galerie d’exemples de Dev Proxy.

Comment votre application gère-t-elle les erreurs d’API ?

Voir aussi