Всем привет, правильно ли так делать swagger? Чего не хватает и

Question

Всем привет, правильно ли так делать swagger? Чего не хватает и

что следует улучшить?

post('create job') do
response(200, 'successful') do

tags "Jobs"
consumes "application/json"
parameter name: :job, in: :body, schema: {
type: :object,
properties: {
id: { type: :integer },
company: { type: :string },
position: { type: :integer },
description: { type: :string },
},
required: ["id", "company", "position", "description"],
}

after do |example|
example.metadata[:response][:content] = {
'application/json' => {
example: JSON.parse(response.body, symbolize_names: true)
}
}
end
run_test!
end
end
end