2016-07-22 30 views
4

Ich verwende Azure App Services und habe die Easy API mit Easy Table für das API-Back-End für mein Mobiltelefon eingerichtet.So aktivieren Sie die Swagger-Benutzeroberfläche in Azure Easy API

Ich frage mich, wie kann ich die Swagger UI für den Azure App Service einrichten.

Wenn ich versuche, zur API zu navigieren (z. B. https://xxxxxx.azurewebsites.net/swagger/ui), heißt es: "Um auf die Swagger-Benutzeroberfläche zugreifen zu können, müssen Sie die Swagger-Unterstützung aktivieren, indem Sie swagger: true zu Ihrer Konfiguration hinzufügen und das swagger-ui npm-Modul installieren"

Wie fügen Sie genau den swagger-ui npm hinzu, wenn Sie nicht die Quelle zur API haben (sie wird automatisch mit Easy API erstellt)?

Antwort

3

Zwei Teile auf Ihre Frage:

1) Aktivieren von Swagger auf EasyAPI ist jetzt nicht möglich. Das heißt, dass wir den Swagger für EasyAPI nicht zusammenführen oder generieren, da alle Parameter im Code definiert sind.

2) Wenn Sie Swagger aktivieren möchten, müssen Sie "swagger: true" zum Initialisierer für Azure Mobile Apps in der app.js-Datei auf der Ebene über Ihrer API hinzufügen. Gehen Sie in Easy API oder Easy Tables und bearbeiten Sie jede API/Tabelle. Dadurch wird der Editor angezeigt. Wechseln Sie in das obige Verzeichnis (das Verzeichnis mit den Verzeichnissen api und tables), und bearbeiten Sie dort die Datei app.js.

+0

Ich habe den swagger: true in der app.js hinzugefügt, aber das Ergebnis mit der obigen URL zum swagger ergibt das gleiche Ergebnis. Ich frage mich, ob wir das swagger-ui npm hinzufügen müssen, da es nicht im Ordner node_module vorhanden ist. – daniel

+0

@daniel Ja, Sie können das Modul über das Git-Repository bereitstellen oder den Befehl npm install commond im App Service Editor ausführen. Weitere Informationen finden Sie unter https://azure.microsoft.com/en-us/documentation/articles/app-service-mobile-node-backend-how-to-use-server-sdk/. –

+1

Nach dem Klonen des Git-Repositorys auf local und Hinzufügen von swagger-ui in der Datei package.json kann nun der Swagger ausgeführt werden. Vielen Dank ! – daniel