O que é o Dev Proxy?

O Dev Proxy é um simulador de API que ajuda você a testar seu aplicativo sem esforço além dos cenários ideais.

Você testa seu aplicativo para garantir que ele funcione conforme o esperado. Mas e se as APIs que você usa falharem? Seu aplicativo perderá os dados do seu cliente? Como você testa isso? Simular falhas de API é difícil. Você acaba escrevendo um código que você não vai entregar ou pior: não testar nada. É por isso que criamos o Dev Proxy, para simular erros de API para que você possa testar facilmente seu aplicativo sem alterar seu código.

Com o Dev Proxy você:

• Veja como seu aplicativo responde a erros de API, sem alterar o código do aplicativo, para que você possa criar aplicativos mais robustos e não perder os dados dos clientes.
• Verifique como seu aplicativo lida com os limites de taxa de API, para que você possa evitar ser limitado e melhorar a experiência do usuário para seus clientes.
• Veja como seu aplicativo lida com APIs lentas, para que você possa implementar as funcionalidades necessárias e torná-lo mais fácil de usar.
• Crie APIs simuladas rapidamente sem escrever uma linha de código, para que você possa se concentrar na criação do aplicativo em vez de escrever código que não será publicado.
• Melhore seu aplicativo com diretrizes contextuais sobre como você usa APIs, para torná-lo ainda melhor.

O Dev Proxy é uma ferramenta de linha de comando que funciona em qualquer plataforma. Por interceptar solicitações de rede, funciona com qualquer tipo de aplicativo e pilha de tecnologia. O Dev Proxy é de código aberto e gratuito.

Para quem é o Dev Proxy?

Dev Proxy ajuda desenvolvedores que:

• Criar aplicativos que chamam APIs – teste como seu aplicativo lida com erros e limites de taxa de APIs como GitHub, OpenAI e Anthropic, sem alterar seu código
• Criar aplicativos com o Microsoft Graph – Obter diretrizes sobre permissões e práticas recomendadas
• Criar APIs – Prototipar e simular APIs antes da implementação
• Automatizar testes – Integrar testes de caos nas pipelines de CI/CD

Quando usar o Proxy de Desenvolvimento

Use o Proxy de Desenvolvimento quando precisar:

• Testar a resiliência da API sem modificar o código do aplicativo
• Trabalhe com qualquer stack tecnológico (navegador, Node.js, .NET, Python, etc.).
• Simular falhas para APIs que você não controla
• Obter diretrizes sobre as práticas recomendadas do Microsoft Graph
• Automatizar o teste de caos em pipelines de CI/CD

Considere outras abordagens quando:

• Você só precisa de simulação em um navegador para os testes de unidade de front-end
• Você está criando a API e precisa de testes de contrato
• Você precisa modificar corpos de solicitação/resposta de forma programática (Dev Proxy pode fazer isso, mas ferramentas dedicadas podem ser mais simples)

Início rápido por cenário

Escolha seu caminho com base no que você deseja realizar:

Corrigir um problema de API

Recebeu um erro de uma API ou está criando um aplicativo ou agente de IA? Comece com o problema:

• Erros e limites:429 Excesso de Solicitações, Retry-After, 500, 502, 503 e 504 erros, limite de taxa da API do GitHub excedido, limite de taxa da OpenAI atingido, Anthropic 529 overloaded_error, .NET timeouts do HttpClient
• Aplicativos de IA e agentes:Limites de taxa de LLM, Verifique o tratamento de erros que seu agente de codificação escreveu, testar o que seu agente de IA faz quando as ferramentas falham, testar seu agente de IA para injeção de prompt em respostas de ferramenta

Experimente com uma predefinição

As predefinições são configurações do Dev Proxy prontas para APIs específicas. Para ver como seu aplicativo lida com os limites de taxa e os erros da API que ele chama, comece instalando o 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)"

Em seguida, baixe a predefinição salva para sua API.

Inicie o Proxy de Desenvolvimento com a predefinição. Substitua github-rate-limiting pela predefinição que você baixou. Na primeira vez que você iniciar o Dev Proxy, você precisará confiar em seu certificado.

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

Execute seu aplicativo como de costume. Ele continua chamando as URLs de API reais e o Dev Proxy simula os limites de taxa e os erros da API.

Para obter predefinições para outras APIs, consulte a galeria de exemplos do Dev Proxy.

Como seu aplicativo lida com erros de API?

Consulte também

• Configurar o Proxy de Desenvolvimento – Instalação e primeira execução
• Configurar o Proxy de Desenvolvimento – Personalizar de acordo com suas necessidades
• Guias passo a passo – Guias orientados por tarefas
• Referência técnica – documentação do plug-in