Welcome

For Ruby on Rails:

The Setup:

Your ActiveResource will look like this:

class VinApi < ActiveResource::Base
  headers["X-VinApiKey"] = "YOUR_API_KEY_GOES_HERE"
  self.site = "http://vinapi.skizmo.com"
  self.element_name = "vin"
end

Examples:

# call from anywhere in your application - models, controllers, views, libs ...
VinApi.find("VIN GOES HERE")

# and get this result set
{"vin"          => "VIN GOES HERE", 
 "year"         => "2003",
 "make"         => "HONDA", 
 "model"        => "ACCORD EX", 
 "body_style"   => "COUPE", 
 "engine_type"  => "3.0L V6  SFI SOHC 24V", 
 "country"      => "UNITED STATES"}

For anything else - use curl

Examples

curl -i -X GET \
  -H "Content-Type: application/xml" \
  -H "X-VinApiKey: YOUR_KEY_GOES_HERE" \
  http://vinapi.skizmo.com/vins/VINGOESHERE.xml