Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
- Découvrez comment votre application répond aux erreurs d’API, sans modifier le code de votre application, afin que vous puissiez créer des applications plus robustes et ne pas perdre les données des clients.
- Vérifiez comment votre application gère les limites de débit d’API afin que vous puissiez éviter d’être limité et améliorer l’expérience utilisateur pour vos clients.
- Découvrez comment votre application gère les API lentes afin de pouvoir implémenter les affordances nécessaires et rendre votre application plus conviviale.
- Mettre en place rapidement des API fictives sans écrire une ligne de code, afin que vous puissiez vous concentrer sur la création de votre application au lieu d'écrire du code que vous n'enverrez pas en production.
- Améliorez votre application avec des conseils contextuels sur l’utilisation des API pour améliorer encore davantage votre application.
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 :
- Erreurs et limites :429 Trop de requêtes, Retry-After, 500, 502, 503 et 504 erreurs, limite de débit d’API GitHub dépassée, limite de débit OpenAI atteinte, Anthropic 529 overloaded_error, .NET délais d’expiration HttpClient
- Applications et agents IA :Limites de débit LLM, Vérifiez la gestion des erreurs qu’a mise en place votre agent de codage, Tester ce que fait votre agent IA lorsque les outils échouent, Testez votre agent IA pour l’injection de prompts dans les réponses des outils
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
- Configurer le proxy de développement - Installation et première exécution
- Configurer le proxy de développement - Personnaliser en fonction de vos besoins
- Guides pratiques - Guides orientés tâches
- Informations techniques de référence - Documentation du plug-in