Swagger:禁用某条特定路径上的安全性

时间:2015-03-12 21:30:19

标签: rest swagger

我有一个以下面的

开头的Swagger文件
{
    "swagger": "2.0",
    "basePath": "/api",
    "schemes": [
        "https"
    ],
    "securityDefinitions": {
        "internalApiKey": {
            "type": "apiKey",
            "name": "AAuthorization",
            "in": "header"
        }
    },
    "security" : [
        { "internalApiKey": [ ] }
    ],

此prolog将安全设置应用于文件中后面的每个路径。例如

"paths": {
    "/foo": {
        "get": {  

我是否可以通过某种方式禁用某个特定路径或方法的安全性?

1 个答案:

答案 0 :(得分:17)

不确定。只需将"security"属性添加到操作中,并将空数组作为值。

类似

{
  "tags": [
    "pet"
  ],
  "summary": "Updates a pet in the store with form data",
  "description": "",
  "operationId": "updatePetWithForm",
  "consumes": [
    "application/x-www-form-urlencoded"
  ],
  "produces": [
    "application/json",
    "application/xml"
  ],
  "parameters": [
    {
      "name": "petId",
      "in": "path",
      "description": "ID of pet that needs to be updated",
      "required": true,
      "type": "string"
    }
  ],
  "responses": {
    "200": {
      "description": "Pet updated."
    }
  },
  "security": [

  ]
}

会使此操作的安全性无效。