7

Swaggerを使用してRESTWebAPIを文書化しています。ペットショップの例をダウンロードしました。それはresources.jsonどの参照pet.jsonと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"
        }
    ]
}

しかし、元のファイルをWebサーバーにアップロードした後でも、SwaggerUIは次のように通知します。

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

Swaggerが私のjsonファイルを見つけられない原因を教えてください。

4

1 に答える 1

4

www.myserver.orgにアクセスすると、Swagger uiが表示されると思いますか？SwaggerUIの[Explore]テキストボックスに...resources.jsonの場所を必ず入力してください。

私は個人的にSwaggerAPIドキュメントをこのように設定しています...

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

ここでより詳細な説明をチェックアウトできます-静的ドキュメントを使用したSwagger

他にご不明な点がございましたら、お気軽にお問い合わせください。

于 2012-07-22T03:15:34.300 に答える