Kann nicht lesen von Dateiproblem in Swagger UI

Question

Ich habe Swagger UI in meiner Anwendung integriert.

Wenn ich versuche, die swagger UI zu sehen, bekomme ich die Dokumentation der API schön, aber nach einiger Zeit zeigt es ein Fehlersymbol auf der Schaltfläche.

Die Fehlermeldung ist wie folgt:

[{ "Level": "Fehler", "message": "Kann nicht aus der Datei http://MYIP/swagger/docs/v1 lesen"}]

I Ich bin mir nicht sicher, was es verursacht. Wenn ich es aktualisiere, funktioniert es und zeigt Fehler nach einigen Sekunden an.

Answer 1

Ich rate "http://MYIP/swagger/docs/v1" ist nicht öffentlich zugänglich.

Standardmäßig verwendet swagger ui einen Online-Validator: online.swagger.io. Wenn es nicht auf Ihre Swagger-URL zugreifen kann, wird diese Fehlermeldung angezeigt.

Mögliche Lösungen:

1. Disable-Validierung:

   config.EnableSwagger().EnableSwaggerUi(c => c.DisableValidator());

2. Machen Sie Ihre Website öffentlich zugänglich

3. Gastgeber der Prüfer vor Ort:

Sie können den Validator Suche von: https://github.com/swagger-api/validator-badge#running-locally

Sie auch

config.EnableSwagger().EnableSwaggerUi(c => c.SetValidatorUrl(<validator_url>));

Answer 2

Um die akzeptierte Antwort ergänzen sich die Position des Prüfers sagen, müssen swaggerui ... ich nur eine uncommented Linie in die SwaggerConfig.cs. Ich wollte nur den roten Fehler auf der Hauptwucherungsseite beseitigen, indem ich den Validator deaktiviere.

// By default, swagger-ui will validate specs against swagger.io's online validator and display the result 
// in a badge at the bottom of the page. Use these options to set a different validator URL or to disable the 
// feature entirely. 
//c.SetValidatorUrl("http://localhost/validator"); 
c.DisableValidator(); 

Answer 3

Wenn Sie PHP Laravel framework mit L5-Swagger nur uncomment

'validatorUrl' => null, 

aus der Konfigurationsdatei mit /config/l5-swagger.php

Answer 4

Einstellung this.model.validatorUrl = null; in dist/swagger-ui.js für mich gearbeitet ..

// Default validator 
if(window.location.protocol === 'https:') { 
    //this.model.validatorUrl = 'https://online.swagger.io/validator'; 
    this.model.validatorUrl = null; 
} else { 
    //this.model.validatorUrl = 'http://online.swagger.io/validator'; 
    this.model.validatorUrl = null; 
}