/savon

Heavy metal SOAP client

Primary LanguageRubyMIT LicenseMIT

Savon

Heavy metal SOAP client

Documentation | Support | Mailing list | Twitter

Build Status Gem Version Code Climate Coverage Status

Version 2

Savon version 2 is available through Rubygems and can be installed via:

$ gem install savon

or add it to your Gemfile like this:

gem 'savon', '~> 2.12.0'

Usage example

require 'savon'

# create a client for the service
client = Savon.client(wsdl: 'http://service.example.com?wsdl')

client.operations
# => [:find_user, :list_users]

# call the 'findUser' operation
response = client.call(:find_user, message: { id: 42 })

response.body
# => { find_user_response: { id: 42, name: 'Hoff' } }

For more examples, you should check out the integration tests.

Ruby version support

  • 2.12.x - MRI 2.2, 2.3, 2.4, 2.5
  • 2.11.x - MRI 2.0, 2.1, 2.2, and 2.3

If you are running MRI 1.8.7, try a 2.6.x release.

Running tests

$ bundle install
$ bundle exec rspec

FAQ

  • URI::InvalidURIError -- if you see this error, then it is likely that the http client you are using cannot parse the URI for your WSDL. Try gem install httpclient or add it to your Gemfile.

Documentation

Please be sure to read the documentation.