Che cos'è Dev Proxy?

Dev Proxy è un simulatore di API che consente di testare facilmente l'app oltre il percorso felice.

Testa l'app per assicurarti che funzioni come previsto. Ma cosa succede se le API usate hanno esito negativo? L'app perderà i dati del cliente? Come si esegue il test per questo? La simulazione degli errori dell'API è difficile. Si finisce per scrivere codice che non verrà spedito o peggio: non testare affatto. Ecco perché è stato creato Dev Proxy, per simulare gli errori dell'API in modo da poter testare facilmente l'app senza modificare il codice.

Con Dev Proxy è possibile:

• Scopri in che modo l'app risponde agli errori dell'API, senza modificare il codice dell'app, in modo da poter creare app più affidabili e non perdere i dati dei clienti.
• Verificare in che modo l'app gestisce i limiti di frequenza delle API, in modo da evitare di essere limitati e migliorare l'esperienza utente per i clienti.
• Scopri in che modo la tua app gestisce le API lente, in modo da poter implementare le funzionalità necessarie e rendere la tua app più intuitiva.
• Configurare rapidamente API fittizie senza scrivere una riga di codice, in modo da poter concentrarsi sulla creazione dell'app invece di scrivere codice che non verrà distribuito.
• Migliorare l'app con indicazioni contestuali su come usare le API per migliorare ulteriormente l'app.

Dev Proxy è uno strumento da riga di comando che funziona su qualsiasi piattaforma. Poiché intercetta le richieste di rete, funziona con qualsiasi tipo di app e stack tecnologico. Dev Proxy è open source e gratuito da usare.

A chi è rivolto Dev Proxy?

Dev Proxy consente agli sviluppatori che:

• Creare app che chiamano API: testare il modo in cui l'app gestisce gli errori e i limiti di frequenza dalle API, ad esempio GitHub, OpenAI e Anthropic, senza modificare il codice
• Creare app con Microsoft Graph - Ottenere indicazioni sulle autorizzazioni e sulle procedure consigliate
• API di progettazione - Creare prototipi e API fittizie prima dell'implementazione
• Automatizzare i test - Integrare i test del caos nelle pipeline CI/CD

Quando usare Dev Proxy

Usare Dev Proxy quando è necessario:

• Testare la resilienza dell'API senza modificare il codice dell'applicazione
• Usare qualsiasi stack tecnologico (browser, Node.js, .NET, Python e così via)
• Simulare gli errori per le API non controllate
• Ottenere indicazioni sulle procedure consigliate di Microsoft Graph
• Automatizzare i test del caos nelle pipeline CI/CD

Prendere in considerazione altri approcci quando:

• Per gli unit test front-end è necessaria solo una simulazione nel browser
• Stai costruendo un'API e sono necessari test di contratto
• È necessario modificare i corpi di richiesta/risposta a livello di codice (Dev Proxy può eseguire questa operazione, ma gli strumenti dedicati potrebbero essere più semplici)

Avvio rapido in base allo scenario

Scegliere il percorso in base a ciò che si vuole eseguire:

Risolvere un problema di API

Hai ricevuto un errore da un'API o stai creando un'app o un agente di intelligenza artificiale? Iniziare dal problema:

• Errori e limiti:429 Troppe richieste, Retry-After, 500, 502, 503 e 504 errori, GitHub limite di frequenza API superato, limite di velocità OpenAI raggiunto, Anthropic 529 overloaded_error, timeout httpClient .NET
• App e agenti di intelligenza artificiale:limiti di frequenza LLM, Verifica la gestione degli errori implementata dal tuo agente di coding, Testare le operazioni eseguite dall'agente di intelligenza artificiale quando l'esecuzione degli strumenti fallisce, Testare l'agente di intelligenza artificiale per la prompt injection nelle risposte degli strumenti

Provalo con un predefinito

I preset sono configurazioni predefinite del proxy di sviluppo per API specifiche. Per vedere come l'app gestisce i limiti di frequenza e gli errori dell'API che chiama, iniziare installando Dev Proxy.

winget install DevProxy.DevProxy --silent

brew tap dotnet/dev-proxy
brew install dev-proxy

bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Scarica quindi il preset per l'API.

Avviare Dev Proxy con la preimpostazione. Sostituire github-rate-limiting con il preset scaricato. La prima volta che si avvia Dev Proxy, è necessario considerare attendibile il certificato.

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

Eseguire l'app come di consueto. Continua a chiamare gli URL api reali e Dev Proxy simula i limiti di frequenza e gli errori dell'API.

Per i set di impostazioni per altre API, vedere la raccolta di esempi di Dev Proxy.

In che modo l'app gestisce gli errori dell'API?

Vedere anche

• Configurare Dev Proxy - Installazione e prima esecuzione
• Configurare il proxy di sviluppo - Personalizzare in base alle esigenze
• Guide pratiche - Guide orientate alle attività
• Riferimento tecnico - Documentazione del plug-in