Skip to content

Commit 74bfc78

Browse files
Adds v3.3.0 announcement
1 parent ba537da commit 74bfc78

2 files changed

Lines changed: 60 additions & 0 deletions

File tree

public/blog/images/v3-3-0.png

477 KB
Loading
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: "Dev Proxy v3.3.0 with query string support for CRUD API actions"
3+
description: "Dev Proxy v3.3.0 adds query string matching to CRUD API actions, so you can simulate common filtering patterns more accurately."
4+
date: 2026-09-14
5+
author: "Waldek Mastykarz, Garry Trinder"
6+
tags: ["release"]
7+
image: "/blog/images/v3-3-0.png"
8+
---
9+
10+
We're excited to announce the release of **Dev Proxy v3.3.0!** This release makes simulated CRUD APIs more realistic by letting actions match query string parameters and use their values to filter data.
11+
12+
### **Match CRUD API actions using query string parameters**
13+
14+
Many APIs use query strings to filter data, such as `GET /jokes?category=azure`. Until now, **CrudApiPlugin** actions matched only URL paths, so you couldn't use the query string to select an action or pass its values into a JSONPath query.
15+
16+
**What changed:**
17+
18+
You can now define literal or parameterized query string values in a CRUD API action. For example:
19+
20+
```json
21+
{
22+
"action": "getMany",
23+
"url": "?category={category}",
24+
"method": "GET",
25+
"query": "$.[?(@.categories[?(@ == '{category}')])]"
26+
}
27+
```
28+
29+
When your app calls `GET /jokes?category=azure`, Dev Proxy captures `azure` as the `{category}` value and uses it in the JSONPath query. Query parameters match regardless of their order, and action definitions can use repeated parameters such as `?id={id1}&id={id2}`. You can also combine path and query parameters in the same action.
30+
31+
**Why this matters:**
32+
33+
You can simulate filtering patterns that real APIs use without creating separate endpoints or custom mocks. Matching also handles edge cases such as URL-valued parameters, quotes in values, and actions that expect more repeated values than the request provides. When a request doesn't satisfy an action, Dev Proxy moves on to another matching action or returns an empty result or 404 instead of failing with a server error.
34+
35+
## Dev Proxy Toolkit
36+
37+
[Dev Proxy Toolkit](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit) is an extension that makes it easier to work with Dev Proxy from within Visual Studio Code. The latest released version is v1.34.0.
38+
39+
In this version, we've:
40+
41+
- Updated all snippets that reference schemas to use the Dev Proxy v3.2.0 schema
42+
43+
Checkout out the [changelog](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit/changelog) for more information on changes and bug fixes.
44+
45+
### **What's next: Dev Proxy v4**
46+
47+
The next version of Dev Proxy will be v4, scheduled for release at the end of October. We're planning to release a beta in the next few days, giving you time to test it before the final release.
48+
49+
Dev Proxy v4 retains the functionality you use today, but its core proxy engine has been rewritten on Kestrel. This is a significant architectural change that replaces the previous Titanium-/Unobtanium-based engine. We've added parity and per-plugin integration tests, but changes at this depth need testing against real applications and traffic.
50+
51+
You can already learn more and try the [latest Dev Proxy v4 alpha release](https://github.com/dotnet/dev-proxy/releases/tag/v4.0.0-alpha.4). When the beta is available, please run it with your existing configurations and let us know about any differences you find. Your feedback will help us make v4 ready for release at the end of October.
52+
53+
### **Why upgrade to v3.3.0?**
54+
55+
**More realistic CRUD mocks** - route actions and filter data using query string values
56+
**Flexible action matching** - combine path parameters with literal, parameterized, or repeated query values
57+
58+
### **Try it now**
59+
60+
Download **Dev Proxy v3.3.0** today and build better API-connected applications with confidence! Got feedback or ideas? [Join us](https://github.com/dotnet/dev-proxy/discussions) and be part of the conversation.

0 commit comments

Comments
 (0)