require 'swagger_helper' describe 'Blogs API', type: :request, swagger_doc: 'v1/swagger.json' do let(:api_key) { 'fake_key' } path '/blogs' do post 'Creates a blog' do tags 'Blogs' description 'Creates a new blog from provided data' operationId 'createBlog' consumes 'application/x-www-form-urlencoded' parameter name: 'blog[title]', :in => :formData, type: 'string' parameter name: 'blog[content]', :in => :formData, type: 'string' parameter name: 'blog[thumbnail]', :in => :formData, type: 'file' response '201', 'blog created' do let(:blog) { { title: 'foo', content: 'bar', thumbnail: Rack::Test::UploadedFile.new(Rails.root.join("spec/fixtures/thumbnail.png")) } } run_test! end response '422', 'invalid request' do schema '$ref' => '#/definitions/errors_object' let(:blog) { { title: 'foo' } } run_test! end end get 'Searches blogs' do tags 'Blogs' description 'Searches blogs by keywords' operationId 'searchBlogs' produces 'application/json' parameter name: :keywords, in: :query, type: 'string' response '200', 'success' do schema type: 'array', items: { '$ref' => '#/definitions/blog' } let(:keywords) { 'foo+bar' } run_test! end end end path '/blogs/{id}' do parameter name: :id, :in => :path, :type => :string get 'Retrieves a blog' do tags 'Blogs' description 'Retrieves a specific blog by id' operationId 'getBlog' produces 'application/json' response '200', 'blog found' do header 'ETag', type: :string header 'Last-Modified', type: :string header 'Cache-Control', type: :string schema '$ref' => '#/definitions/blog' examples 'application/json' => { id: 1, title: 'Hello world!', content: 'Hello world and hello universe. Thank you all very much!!!', thumbnail: "thumbnail.png" } let(:blog) { Blog.create(title: 'foo', content: 'bar', thumbnail: 'thumbnail.png') } let(:id) { blog.id } run_test! end response '404', 'blog not found' do let(:id) { 'invalid' } run_test! end end end path '/blogs/{id}/upload' do parameter name: :id, :in => :path, :type => :string put 'upload a blog thumbnail' do tags 'Blogs' description 'Upload a thumbnail for specific blog by id' operationId 'uploadThumbnailBlog' consumes 'application/x-www-form-urlencoded' parameter name: :file, :in => :formData, :type => 'file', required: true response '200', 'blog updated' do let(:blog) { Blog.create(title: 'foo', content: 'bar') } let(:id) { blog.id } let(:file) { Rack::Test::UploadedFile.new(Rails.root.join("spec/fixtures/thumbnail.png")) } run_test! end response '404', 'blog not found' do let(:id) { 'invalid' } let(:file) { Rack::Test::UploadedFile.new(Rails.root.join("spec/fixtures/thumbnail.png")) } run_test! end end end end