2012-07-11 7 views
6

Estoy documentando una API web de REST con Swagger. He descargado el ejemplo de la tienda de mascotas. Consiste en la resources.json que hace referencia a pet.json y user.json:Error de IU de Swagger: no se puede recuperar el listado de API

{ 
    "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" 
     } 
    ] 
} 

Pero incluso después de subir los archivos originales a mi servidor web, Swagger interfaz de usuario me dice:

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 

Se puede decir lo que causa Swagger no encontrar mi archivo json?

Respuesta

4

Supongo que vas a www.myserver.org y te muestra el arrogante ui? En el cuadro de texto "Explorar" en la interfaz de usuario de Swagger ... asegúrese de escribir la ubicación de sus recursos.json.

personalmente he puesto mi documentación de la API arrogancia de esta manera ...

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 

se puede retirar una explicación más detallada aquí - Swagger With Static Documentation

Si tiene más preguntas no dude en preguntar.

Cuestiones relacionadas