Add the ability to configure a host

[kevinthompson]

When an API only responds to calls on a given subdomain, it seems the full url must be specified in the example group. It would be preferable to specify the api host in the configuration instead.

[oestrich]

Could you give an example of how you're currently using it, then how you would like to to be? I'm not sure I entirely understand.

[kevinthompson]

In the example block below, in my get method call, I have to define the full url and I believe that's because my application has a few subdomain constraints. Without the full host specified, the specs fail.

require 'spec_helper'
require 'rspec_api_documentation/dsl'

resource 'Albums' do
  parameter :auth_token, 'Authentication token'

  let(:user){ create(:user) }
  let(:photo){ create(:photo, user: user) }
  let(:auth_token){ user.authentication_token }

  get 'https://app.example.com/api/v1/albums.json' do

    before do
      create(:album, user: user)
    end

    example_request 'List Albums' do
      status.should == 200
      response_json = JSON.parse(response_body)
      response_json['errors'].should be_empty
      albums = response_json['data']
      albums.any?{ |album| album['name'] == 'Example Album' }.should be_true
    end
  end
end

[oestrich]

I'm not entirely sure how to get around this. I think we have to mess with the env["HOST"] which we can't get to from the DSL level and is client specific (rack, oauth). Issue #50 seems to be pretty similar. We can possibly add a new DSL to make the client change the host properly. Seems like it might be a good way around this.