O que é Dev Proxy?

O Dev Proxy é um simulador de API que ajuda você a testar seu aplicativo sem esforço além do caminho feliz.

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 cliente? Como você testa isso? Simular falhas de API é difícil. Você acaba escrevendo um código que não vai enviar ou pior: não está testando 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 a sua aplicação responde a erros da API, sem alterar o código da sua aplicação, para que possa construir aplicações mais robustas 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 os recursos necessários e tornar seu aplicativo mais fácil de usar.
• Crie rapidamente APIs simuladas sem escrever uma linha de código, para que você possa se concentrar na criação de seu aplicativo em vez de escrever código que não será enviado.
• Melhore seu aplicativo com orientações contextuais sobre como você usa APIs, para torná-lo ainda melhor.

Dev Proxy é uma ferramenta de linha de comando que funciona em qualquer plataforma. Como interceta solicitações de rede, funciona com qualquer tipo de aplicação e pilha de tecnologia. Dev Proxy é de código aberto e livre para usar.

Para quem é o Dev Proxy?

Dev Proxy ajuda programadores que:

• Constrói aplicações que chamam APIs – Testa como a tua app lida com erros e limites de taxa de APIs como GitHub, OpenAI e Anthropic, sem alterar o teu código
• Construa aplicações com Microsoft Graph - Obtenha orientações sobre permissões e melhores práticas
• APIs de Design - APIs de protótipo e mock antes da implementação
• Automatizar testes - Integrar testes de caos nos pipelines CI/CD

Quando usar Dev Proxy

Use o Dev Proxy quando precisar:

• Teste a resiliência da API sem modificar o código da sua aplicação
• Trabalhe com qualquer stack tecnológico (browser, Node.js, .NET, Python, etc.)
• Simula falhas para APIs que não controlas
• Obtenha orientação sobre as melhores práticas do Microsoft Graph
• Automatizar testes de caos em pipelines CI/CD

Considere outras abordagens quando:

• Só precisas de simulação no próprio navegador para testes unitários da interface
• Estás a construir a API e precisas de testes por contrato
• Precisas de modificar os corpos de pedido/resposta programaticamente (o Dev Proxy pode fazer isso, mas ferramentas dedicadas podem ser mais simples)

Início rápido por cenário

Escolha o seu caminho com base no que pretende alcançar:

Resolver um problema de API

Recebeste um erro de uma API, ou estás a criar uma aplicação ou agente de IA? Começa pelo problema:

• Erros e limites:429 Demasiados Pedidos, Retry-After, 500, 502, 503 e 504 erros, limite de taxa da API do GitHub ultrapassado, limite de taxa OpenAI atingido, Anthropic 529 overloaded_error, .NET timeouts do HttpClient
• Aplicações e agentes de IA:limites de taxa dos LLMs, verificar o tratamento de erros escrito pelo seu agente de codificação, testar o que o seu agente de IA faz quando as ferramentas falham, testar o seu agente de IA para injeção de prompts nas respostas das ferramentas

Experimente com uma predefinição

Os presets são configurações de Proxy de Desenvolvimento prontas para APIs específicas. Para ver como a tua aplicação lida com os limites de taxa e erros da API a que recorre, começa por instalar 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)"

De seguida, descarregue a predefinição da sua API.

Iniciar o Dev Proxy com a predefinição. Substitui github-rate-limiting pelo preset que descarregaste. Na primeira vez que iniciares o Dev Proxy, tens de confiar no certificado.

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

Executa a tua aplicação como de costume. Continua a chamar os URLs reais da API, e o Dev Proxy simula os limites de taxa e erros da API.

Para 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 Proxy de Desenvolvimento - Instalação e primeira execução
• Configurar o Proxy de Desenvolvimento - Personalize de acordo com as suas necessidades
• Guias práticos - Guias orientados para tarefas
• Referência técnica - Documentação de plugins