🚀 Aggregating OpenAPI docs on a YARP gateway
Years ago I built MMLib.SwaggerForOcelot so you’d get one Swagger view for all the services behind an Ocelot gateway. It grew past 3.8M downloads, which still surprises me.
But the stack moved on - Ocelot to YARP, Swashbuckle to Microsoft.OpenApi, Swagger UI to Scalar. So I rebuilt the idea from scratch: MMLib.OpenApiForYarp.
🛠️ What it does: → Fetches each downstream service’s OpenAPI document at runtime → Rewrites the paths to match how the gateway exposes them - read straight from your YARP routes, no parallel config → Serves a clean per-service or merged document in Scalar (or Swagger UI)
It’s three lines to turn on, and the path rewriting comes automatically from your existing YARP transforms.
⚠️ It’s a v1, so there are gaps - no request aggregation yet, no dynamic reload. If something’s missing for your setup, issues and PRs are welcome.
https://blog.burgyn.online/2026/06/19/mmlib-openapiforyarp
#dotnet #yarp #openapi #aspnetcore
I rebuilt MMLib.SwaggerForOcelot for the modern stack - YARP, Microsoft.OpenApi, Scalar. One clean OpenAPI view for every service behind your gateway, in three lines.
https://blog.burgyn.online/2026/06/19/mmlib-openapiforyarp
#dotnet #yarp