Advanced ASP.NET Core Web APIs: testen und dokumentieren – aber richtig!

Session Abstract

Jeder baut Web-APIs, oder? Leider ist es nicht damit getan, ein neues Projekt zu erzeugen, ein paar Controller zu implementieren und dann sein Web-API zu deployen. Zum einen sollte es vernünftig dokumentiert werden, damit die Entwickler, die mit unserem API arbeiten müssen, auch wissen, was es kann und wie es funktioniert. Zum anderen sollten wir selber auch sicherstellen, dass unser API das tut, was es soll. In dieser Session zeigt Ihnen Sebastian Gingter, wie man diese beiden Fliegen mit einer Klappe schlagen kann. Mit Hilfe von Open API/Swagger erzeugen wir erst eine umfassende, ständig aktuelle und lebendige Dokumentation unseres APIs. Im zweiten Schritt generieren wir aus dieser Dokumentation auch gleich Tests für das API-Test-Tool Postman, die wir dann mit etwas JavaScript Testcode anreichern und diese sogar als automatisierte Integrationstests laufen lassen können. Web-APIs jenseits von Hello World, mit viel Projekterfahrung.

Related Articles

.net core
(ASP).NET Core in production - Changing log level temporarily - 2nd approach
In the previous blog post I talked about how to change the log level at runtime by coupling the (or rather the ) with the . However, the solution has one drawback: you need to change the file  for that. In this post we will be able to change the log level without changing the…
Pawel Gerr
.net core
.NET Core in production - Changing log level temporarily
When running the application in production then the log level is set somewhere between and . The question is what to do if you or your customer experiences some undesired behavior and the logs with present log level aren't enough to pinpoint the issue. The first solution that…
Pawel Gerr
entity framework core
Unnecessary Fuzzy Searches may hurt your Entity Framework Core Performance
After talking about performance issues like N+1 Queries and the Cartesian Explosion that made its comeback in Entity Framework Core 3, we will today look at a performance issue that is not tied to any Entity Framework version but is rather a general one. What do I mean by…
Pawel Gerr
entity framework core
The performance issue "Cartesian Explosion" made its comeback in Entity Framework Core 3
In Entity Framework Core 3.0/3.1 the SQL statement generation underwent significant changes. As we have seen in the previous post these changes removed both the implicit client-side evaluation and the N+1 Query Problem (which is good!). Unfortunately, these changes (re)introduced…
Pawel Gerr