Swagger mit ASP.NET v5 Azure API App
Ich versuche, mit Swagger + Swashbuckle eine Api-App (Azure) einzurichten, wie Scott Hanselman auf der // Build-Konferenz hier gezeigt hat: Ссылка .
Ich habe (mit NuGet) die Pakete Swagger.Api und Swashbuckle.Core installiert. Es hat keine Controller oder Einstellungen hinzugefügt, die ich erwarten würde, um eine protzige Seite zu haben. Wenn ich zu {baseUrl} \ swagger navigiere, erhalte ich einen Fehler 404.
Ich würde denken, dass es, da es eine Benutzeroberfläche hat, eine Web-App zusätzlich zur Api-App benötigen würde, aber ich habe die Demo erneut angesehen und Scott sagt klar, dass Sie Swagger + Swashbuckle zu jeder Api-App hinzufügen können. In einer zweiten App würde ich allerdings denken, dass es Probleme mit der Api-Entdeckung geben könnte. Hat jemand das schon erfolgreich eingerichtet?
3 Antworten
Diese Antwort ist jetzt veraltet. Siehe die andere Antwort.
Es gibt einen schönen Blogpost, der das Problem beschreibt, das Sie haben: Ссылка
Hier wird beschrieben, wie Sie den Ahoy! Paket zu einem ASP.NET v6 Web API-Projekt und Hinzufügen dieser als eine API-App zu Azure.
Hier ist eine andere Quelle: Ссылка
Die Zeit rollt weiter und jetzt funktioniert Swashbuckle für vNext (beta8 für mich, wahrscheinlich auch andere Versionen) - danke an das Team und die Mitwirkenden!
Fügen Sie in project.json das Paket hinzu:
%Vor%In startup.cs in ConfigureServices ():
%Vor%In startup.cs in Configure ():
%Vor%Jetzt können Sie auf Ihre API-Domain zugreifen - Ссылка
Greifen Sie auf Ihre Swagger-Definition zu - Ссылка
Nehmen wir dann an, Sie haben mindestens eine internetbasierte dev / uat / staging / prod-Umgebung, greifen Sie auf die Definitions-URL und führen Sie dann Datei- & gt; Importieren Sie URI in Ссылка - jetzt haben Sie Code-Gen für ungefähr 20 Klienten auch:)
Sie können auch Ihren eigenen Code-Gen-Server einrichten, wenn Sie auch dazu geneigt sind ( Ссылка ) Ich nutzte den vorhandenen Online-Generator. Der Online-Editor hat auch vollständige Modell- und Beziehungsdefinitionen, zumindest in meinem Fall, wo ich mein Modell vollständig mit EF7 definiert habe (ich weiß, ick ... aber es ist viel besser als & lt; = EF6 und ServiceStack unterstützt CoreCLR noch nicht ). Abhängig von der Größe Ihres Projekts können Sie dadurch ein paar Stunden bis zu einigen Wochen Arbeitsdokumenten sparen und sich dynamisch aktualisieren, während Sie mehr Code schreiben. Und Sie können damit auch Ihre Endpunkte testen, aber ich bevorzuge immer noch PostMan.
Vollständiges Beispielprojekt unter Ссылка
Big ups zu MrSheepUK
HTH
Sie haben die richtigen Schritte gemacht, aber leider funktioniert Swashbuckle für ASP.NET 5 noch nicht.
Sie können Ahoi bekommen! Das ist die nächste Version von Swashbuckle, die ASP.NET v6 hier unterstützt. Das sollte alles funktionieren lassen.
Tags und Links azure asp.net swagger swashbuckle