Partager via


Glossaire du proxy de développement

Ce glossaire définit les termes utilisés dans la documentation du proxy de développement.

A

Simulateur d’API

Outil qui imite le comportement d’une API sans se connecter au serveur d’API réel. Le proxy de développement est un simulateur d’API qui peut simuler des réponses, simuler des erreurs et injecter la latence.

C

Test de chaos

Méthodologie de test qui introduit délibérément des défaillances dans un système pour vérifier qu’elle peut gérer des conditions inattendues. Le proxy de développement permet de tester le chaos en simulant des erreurs et des échecs d’API aléatoires.

Fichier de configuration

Fichier JSON (devproxyrc.json) qui définit le comportement du proxy de développement, y compris les URL à surveiller, les plug-ins à activer et les paramètres spécifiques au plug-in. Consultez Configurer le proxy de développement.

E

Simulation d’erreur

La pratique de faire échouer intentionnellement des appels d'API pour tester comment une application gère les échecs. Le proxy de développement simule les erreurs en retournant des réponses d’erreur HTTP au lieu de transférer des requêtes vers l’API réelle.

I

Intercept

Lorsque le proxy de développement capture une requête HTTP/HTTPS avant d’atteindre sa destination. Les requêtes interceptées peuvent être transmises à l’API, modifiées ou remplacées par des réponses fictifs.

L

Latence

Délai entre l’envoi d’une demande et la réception d’une réponse. Le proxy de développement peut injecter une latence artificielle pour simuler des conditions réseau lentes ou des API surchargées.

M

Réponse factice

Réponse prédéfinie retournée par le proxy de développement au lieu de transférer une requête à l’API réelle. Les simulations sont utiles pour les tests sur les API qui n’existent pas encore ou lorsque vous souhaitez des réponses prévisibles.

Fichier fictif

Fichier JSON (souvent mocks.json) contenant des définitions de réponse fictifs. Chaque entrée mappe un modèle d’URL à un corps de réponse, un code d’état et des en-têtes.

P

Traverser

Lorsque le proxy de développement transfère une requête à l’API réelle sans modification. Cela se produit lorsqu’une demande ne correspond à aucun plug-in actif ou quand les plug-ins décident de ne pas agir dessus.

Plug-in

Composant modulaire qui étend les fonctionnalités du proxy de développement. Les plug-ins peuvent intercepter des demandes, générer des rapports ou fournir des conseils. Consultez l’architecture du plug-in.

Preset

Fichier de configuration prédéfini pour les scénarios courants. Les présélections combinent des plug-ins et des paramètres pour accomplir des tâches spécifiques. Consultez Utiliser des configurations prédéfinies.

Proxy

Serveur qui se trouve entre une application cliente et un serveur d’API, relayant les demandes et les réponses. Le proxy de développement s’exécute en tant que proxy local sur votre ordinateur.

R

Limitation du débit

Une API technique permet de limiter le nombre de demandes qu’un client peut effectuer dans une période donnée. Le proxy de développement peut simuler la limitation du débit en retournant 429 réponses (trop de requêtes). Comparez avec la limitation.

Enregistrement

Processus de capture des demandes et réponses d’API pour une analyse ultérieure. Le proxy de développement peut enregistrer le trafic et l’exporter vers différents formats.

Journaliste

Plug-in qui convertit les données enregistrées en formats lisibles par l’homme comme Markdown, JSON ou texte brut. Les générateurs de rapports traitent le résultat des plug-ins de création de rapports.

Plug-in de création de rapports

Plug-in qui analyse les demandes enregistrées et génère des rapports sur l’utilisation de l’API, les autorisations ou les meilleures pratiques.

S

Schema

Fichier de schéma JSON qui définit la structure et les règles de validation pour les fichiers de configuration du proxy de développement. Les schémas activent IntelliSense dans les éditeurs qui les prennent en charge.

Shadow API

Point de terminaison d’API qu’une application utilise, mais qui n’est pas officiellement documenté ou connu de l’organisation. Le proxy de développement peut vous aider à découvrir les API d’ombre.

T

Throttling

Lorsqu’une API ralentit intentionnellement ou rejette les demandes en raison d’une charge élevée ou d’une protection des ressources. Souvent interchangeable avec la limitation de débit, bien que l'étranglement désigne généralement une condition temporaire, tandis que la limitation de débit est une politique fixe.

U

URL à regarder

Modèles d’URL que le proxy de développement surveille pour les requêtes. Seules les requêtes correspondant à ces modèles sont interceptées. Les modèles prennent en charge les caractères génériques, par exemple https://api.contoso.com/*.

W

Montre

Pour surveiller les demandes adressées à des URL spécifiques. Dev Proxy surveille les URL que vous configurez et pouvez intercepter les demandes correspondantes.

Voir aussi