Swagger UI-Fehler: API-Listing konnte nicht abgerufen werden

Question

Ich dokumentiere eine REST-Web-API mit Swagger. Ich habe das Petstore-Beispiel heruntergeladen. Es besteht aus dem resources.json die verweist pet.json und user.json:

{ 
    "apiVersion":"0.2", 
    "swaggerVersion":"1.0", 
    "basePath":"http://petstore.swagger.wordnik.com/api", 
    "apis": 
    [ 
     { 
      "path":"/pet.{format}", 
      "description":"Operations about pets" 
     }, 
     { 
      "path":"/user.{format}", 
      "description":"Operations about user" 
     } 
    ] 
} 

Aber auch nach der Original-Dateien auf meiner Web-Server hochladen, Swagger UI sagt mir:

Unable to fetch API Listing. Tried the following urls: 
http://www.myserver.org/resources.json 
http://www.myserver.org 
http://www.myserver.org/resources.json 
http://www.myserver.org/resources 

Können Sie sagen, was bewirkt, dass Swagger nicht gefunden meine JSON-Datei?

Answer 1

Ich gehe davon aus, dass Sie zu www.myserver.org gehen und es bringt die Swagger Ui? Im Textfeld "Explore" in der Swagger-Benutzeroberfläche ... geben Sie den Speicherort Ihrer Ressource.json ein.

Ich persönlich habe meine Prahlerei api-Dokumentation auf diese Weise eingerichtet ...

http://adamclerk.com/api   --Swagger UI 
http://adamclerk.com/api/doc  --returns json representing resources.js 
http://adamclerk.com/api/doc/donuts --returns json representing donut operations 

Sie eine ausführlichere Erläuterungen hier Kasse können - Swagger With Static Documentation

Wenn Sie weitere Fragen haben, fühlen sich frei zu fragen.