Wofür ist das?
Beim Entwickeln können wir alle Endpoints im Browser sehen und ausprobieren. Live ist es abgeschaltet. Die Swagger-Oberfläche entsteht automatisch aus den Controllern; dort sieht man, welche Felder ein Endpoint erwartet und was er zurückgibt. Sie ist nur in der Entwicklungsumgebung an. Live allen eine Karte aller Endpoints zu zeigen, bringt nichts, außer einem Angreifer die Arbeit zu erleichtern.
Warum haben wir das gewählt?
Wer das Frontend schreibt, sieht die Form einer Anfrage, ohne den API-Code zu öffnen. Weil die Doku mit dem Code wechselt, veraltet sie nicht.
