Swagger: wyłączenie zabezpieczeń na jednej konkretnej ścieżki

Question

Mam plik Swagger, który rozpoczyna się następnego

{ 
    "swagger": "2.0", 
    "basePath": "/api", 
    "schemes": [ 
     "https" 
    ], 
    "securityDefinitions": { 
     "internalApiKey": { 
      "type": "apiKey", 
      "name": "AAuthorization", 
      "in": "header" 
     } 
    }, 
    "security" : [ 
     { "internalApiKey": [ ] } 
    ], 

Ten prolog stosuje ustawienia zabezpieczeń do każdej ścieżki, który następuje w pliku. Na przykład.

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

Czy istnieje sposób, w jaki mogę wyłączyć ochronę tylko na jednej konkretnej ścieżce lub metodzie?

Answer 1

Pewnie. Po prostu dodaj właściwość "security" do pracy z pustą tablicą jako wartością.

Więc coś

{ 
    "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": [ 

    ] 
} 

by zniweczyć bezpieczeństwa dla tej operacji.