标记匿名方法:swagger 3.0.2版

时间:2017-03-23 10:25:12

标签: swagger swagger-2.0

我正在使用Swagger-ui version 3.0.2,我在本地托管它并提供了我的Json文件和API它打开文档很好并列出了json文件中的所有方法,在我将基本身份验证放入其中后,我做了.JSON文件中的更改,但有一些方法我想标记为匿名。

{
    "swagger": "2.0",
    "info": {
        "description": "description",
        "version": "1.0",
        "title": "API"
    },
    "host": "localhost",
    "schemes": [
        "http"
    ],
    "securityDefinitions": {
        "anonymous_auth": {
            "type": ""
        },
        "basic_auth": {
            "type": "basic",
            "name": "basic_auth",
            "description": "Basic Authentication"
        },
        "token": {
            "type": "apiKey",
            "description": "API Token Authentication",
            "name": "apikey",
            "in": "header"
        }
    },
    "security": [
        {
            "basic_auth": [ ]
        },
        {
            "token": [ ]
        }
    ],
    "paths": {
        //somthing
    },
    "definitions": {  
        //something    
    }
}

通过这种方式使用安全性属性,它将保护完整的文件,但我有一些应该是匿名的方法。

1 个答案:

答案 0 :(得分:2)

要删除全局security,请在操作中添加一个空的security数组:

"paths": {
  "/something:": {
    "get": {
      "security": [],
      ...
    }
  }
}


此外,您的规范无效:

  1. 删除anonymous_auth

  2. name移除basic_auth - name仅用于apiKey安全方案,以指定包含API的标头或查询参数的名称键。