https://github.com/dotnet/dev-proxy

Simulate API failures, throttling, and chaos — all from your command line.
https://github.com/dotnet/dev-proxy

api-testing chaos-engineering dev-proxy developer-tools development devtools hacktoberfest http microsoft-365 microsoft-graph mock-server openapi proxy resilience rest

Last synced: 24 days ago
JSON representation

Simulate API failures, throttling, and chaos — all from your command line.

• Host: GitHub
• URL: https://github.com/dotnet/dev-proxy
• Owner: dotnet
• License: mit
• Created: 2022-09-09T18:11:29.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-05-12T13:24:12.000Z (26 days ago)
• Last Synced: 2025-05-12T14:45:53.716Z (26 days ago)
• Topics: api-testing, chaos-engineering, dev-proxy, developer-tools, development, devtools, hacktoberfest, http, microsoft-365, microsoft-graph, mock-server, openapi, proxy, resilience, rest
• Language: C#
• Homepage: https://aka.ms/devproxy
• Size: 6 MB
• Stars: 637
• Watchers: 15
• Forks: 75
• Open Issues: 62
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Support: SUPPORT.md

Awesome Lists containing this project

README

        


    

  
Dev Proxy






  Test the untestable



 



    

        

    





    

        

    





  Get started |

  Documentation





  Example |

  Features |

  Trademarks





    

  

    

    

    📽️ Simulate throttling using Dev Proxy

    

  

  

  



Dev Proxy is a command line tool for simulating APIs for testing apps.

It aims to provide a better way to test applications.

Use the proxy to:

- simulate errors

- simulate API behaviours

- mock responses

Identify and fix issues in your code before they reach production.

## Get started

Begin with our [tutorial](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/get-started/). It will guide you through the installation process and running the proxy for the first time.

## Example

Fail requests (with a 50% chance) and respond with `429 Too Many Requests` or `503 Service Unavailable`:

```text

devproxy --failure-rate 50 --no-mocks --allowed-errors 429 503

```

## Features

- run on any OS

  - Windows

  - macOS

  - Linux

- intercept requests from Microsoft Graph and other APIs

- simulate errors

- simulate throttling

- simulate rate-limiting

- mock responses

- mock error responses

- define wildcard paths to serve mocked responses

- mock responses of different types (JSON, binary, etc.)

- `$select` guidance to improve performance

- caching guidance to improve performance

- OData paging guidance

- client-request-id header guidance

- non-production beta endpoint guidance for Microsoft Graph

- configure proxy to your needs, by setting:

  - failure rate

  - port

  - whether to use mock responses or not

  - URLs to intercept traffic

- record proxy activity

- get proxy activity summary report

- detect minimal Microsoft Graph API permissions

- check for excessive Microsoft Graph API permissions

### .NET Foundation

This project is supported by the [.NET Foundation](https://dotnetfoundation.org).