Какова цель имени для параметра тела Swagger?

Question

Как показано ниже, я имя параметра тела main_name_of_parameter:

swagger: "2.0" 

info: 
    title: Learing Swagger Title 
    description: Learing Swagger Description 
schemes: 
    - http 
host: testing.example.com 
basePath: /api 
consumes: 
    - application/json 
produces: 
    - application/json 

paths: 
/test: 
    post: 
     summary: testing a post 
     description: testing a post 
     parameters: 
     - name: main_name_of_parameter 
      in: body 
      description: main_name_of_parameter 
      schema: 
      properties: 
       property_one: 
       type: string 
       property_two: 
       type: string 

Затем я проверить его с помощью Сваггер UI, и он генерирует следующий завиток:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \ 
    "property_one": "string", \ 
    "property_two": "string" \ 
}' 'http://testing.example.com/api/test' 

Как видно, main_name_of_parameter никогда не было отправлено к серверу. Какова цель имени для параметра тела Swagger?

Answer 1

Ну, это имя используется для генераторов кода, как имя параметра для генерируемых методов. Но, как вы заявили, на самом деле нет пользы для имени, и на самом деле это removed in the 3.0 specification.