thrillcall-api 0.0.6 → 0.1.0

data/lib/thrillcall-api.rb

@@ -3,8 +3,32 @@ require 'json'
 require "#{File.expand_path("../thrillcall-api/exceptions", __FILE__)}"
 require "#{File.expand_path("../thrillcall-api/result", __FILE__)}"
 require "#{File.expand_path("../thrillcall-api/version", __FILE__)}"
+require 'net/http'
+require 'retriable'
 
 module ThrillcallAPI
+
+  RETRY_ERRNO     = [Errno::ECONNREFUSED,
+                      Errno::ECONNRESET,
+                      Errno::EHOSTUNREACH,
+                      Errno::EHOSTDOWN,
+                      Errno::EINVAL]
+  RETRY_NET       = [Net::HTTPBadResponse,
+                      Net::HTTPRequestTimeOut,
+                      Net::HTTPServerError,          # 5xx
+                      Net::HTTPInternalServerError,  # 500
+                      Net::HTTPNotImplemented,       # 501
+                      Net::HTTPBadGateway,           # 502
+                      Net::HTTPServiceUnavailable,   # 503
+                      Net::HTTPGatewayTimeOut,       # 504
+                      Net::HTTPVersionNotSupported]  # 505
+  RETRY_FARADAY   = [Faraday::Error,
+                      Faraday::Error::ClientError]
+  RETRY_DEFAULT   = [Timeout::Error,
+                      EOFError,
+                      SocketError]
+  RETRY_ALL       = RETRY_DEFAULT + RETRY_ERRNO + RETRY_NET + RETRY_FARADAY
+
   class << self
     attr_accessor :cur_api_key, :base, :result, :conn
 
@@ -19,6 +43,10 @@ module ThrillcallAPI
 
       opts = default_options.merge(options)
 
+      @retry_exceptions = opts[:retry_exceptions] || RETRY_ALL
+      @retry_tries      = opts[:retry_tries]      || 5
+      @retry_timeout    = opts[:timeout]          || 10
+
       @cur_api_key  = cur_api_key
       base_url      = opts[:base_url]
       version       = opts[:version]
@@ -59,20 +87,38 @@ module ThrillcallAPI
       return self
     end
 
+    def on_retry_exception
+      Proc.new do |exception, tries|
+        msg = "ThrillcallAPI : #{exception.class}: '#{exception.message}' - #{tries} attempts."
+        @conn.send(:warn, msg)
+      end
+    end
+
     def get(endpoint, params)
-      r = @conn.get do |req|
-        req.url endpoint, params.merge(:api_key => @cur_api_key)
+      r = nil
+      retriable :on => @retry_exceptions, :tries => @retry_tries, :timeout => @retry_timeout, :on_retry => on_retry_exception do
+        r = @conn.get do |req|
+          req.url endpoint, params.merge(:api_key => @cur_api_key)
+        end
       end
       JSON.parse(r.body)
     end
 
-    def post(endpoint, params)
-      r = @conn.post do |req|
+    def post(endpoint, params, method = :post)
+      r = nil
+      block = lambda do |req|
         req.url endpoint, params.merge(:api_key => @cur_api_key)
       end
+      retriable :on => @retry_exceptions, :tries => @retry_tries, :timeout => @retry_timeout, :on_retry => on_retry_exception do
+        r = @conn.send(method, &block)
+      end
       JSON.parse(r.body)
     end
 
+    def put(endpoint, params)
+      post(endpoint, params, :put)
+    end
+
     def method_missing(method, *args, &block)
       r = Result.new
       r.send(method, args, block)

data/lib/thrillcall-api/result.rb

@@ -107,17 +107,21 @@ module ThrillcallAPI
       @ran = true
     end
     
-    def post(args = {})
+    def post(args = {}, method = :post)
       if @ran
         raise ArgumentError, "This request has already been made!"
       else
-        @http_method = :post
+        @http_method = method
         @options.merge!(args)
         fetch_data
       end
       @data
     end
     
+    def put(args = {})
+      post(args, :put)
+    end
+    
     def method_missing(method, *args, &block)
       
       if @ran

data/lib/thrillcall-api/version.rb

@@ -1,3 +1,3 @@
 module ThrillcallAPI
-  VERSION = "0.0.6"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thrillcall-api
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-16 00:00:00.000000000 Z
+date: 2013-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -228,7 +228,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.7.0
+        version: 0.8.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -236,7 +236,23 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.7.0
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: retriable
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.3
 description: Simple wrapper around http://thrillcall.com's API
 email:
 - github@thrillcall.com
@@ -244,28 +260,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .autotest
-- .gitignore
-- .rspec
-- .rvmrc
-- Gemfile
-- Gemfile.lock
-- README.md
-- Rakefile
-- autotest/discover.rb
-- docs/API.html
-- docs/API.md
-- docs/README.html
-- docs/WRAPPER.html
-- docs/WRAPPER.md
-- lib/thrillcall-api.rb
 - lib/thrillcall-api/exceptions.rb
 - lib/thrillcall-api/result.rb
 - lib/thrillcall-api/version.rb
-- script/convert_readme.rb
-- spec/spec_helper.rb
-- spec/thrillcall-api/thrillcall-api_spec.rb
-- thrillcall-api.gemspec
+- lib/thrillcall-api.rb
 homepage: https://github.com/thrillcall/thrillcall-api
 licenses: []
 post_install_message: 
@@ -278,6 +276,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -14664519067324063
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -286,7 +287,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: thrillcall-api
-rubygems_version: 1.8.21
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: Simple wrapper around http://thrillcall.com's API

data/.autotest

@@ -1,10 +0,0 @@
-# Include plugins
-require 'autotest/fsevent'
-require 'autotest/growl'
-
-# Skip some paths
-Autotest.add_hook :initialize do |autotest|
-  %w{.git .DS_Store ._* vendor tmp}.each { |exception| autotest.add_exception(exception) }
-  false
-end
-

data/.gitignore

@@ -1,10 +0,0 @@
-pkg/*
-*.gem
-.bundle
-log/
-tmp/
-
-# osx noise
-.DS_Store
-profile
-

data/.rspec

@@ -1,4 +0,0 @@
---color
---format d
---backtrace
-

data/.rvmrc

@@ -1,2 +0,0 @@
-rvm ruby-1.9.2-p290@thrillcall-api
-

data/Gemfile

@@ -1,4 +0,0 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in thrillcall_api.gemspec
-gemspec

data/Gemfile.lock

@@ -1,64 +0,0 @@
-PATH
-  remote: .
-  specs:
-    thrillcall-api (0.0.5)
-      faraday (~> 0.7.0)
-
-GEM
-  remote: http://rubygems.org/
-  specs:
-    ZenTest (4.6.2)
-    addressable (2.2.7)
-    albino (1.3.3)
-      posix-spawn (>= 0.3.6)
-    autotest (4.4.6)
-      ZenTest (>= 4.4.1)
-    autotest-fsevent (0.2.8)
-      sys-uname
-    autotest-growl (0.2.16)
-    awesome_print (1.0.2)
-    diff-lcs (1.1.3)
-    faker (0.9.5)
-      i18n (~> 0.4)
-    faraday (0.7.6)
-      addressable (~> 2.2)
-      multipart-post (~> 1.1)
-      rack (~> 1.1)
-    ffi (1.0.11)
-    i18n (0.6.0)
-    multipart-post (1.1.5)
-    nokogiri (1.4.7)
-    posix-spawn (0.3.6)
-    rack (1.4.1)
-    rake (0.9.2.2)
-    redcarpet (1.17.2)
-    rspec (2.7.0)
-      rspec-core (~> 2.7.0)
-      rspec-expectations (~> 2.7.0)
-      rspec-mocks (~> 2.7.0)
-    rspec-core (2.7.1)
-    rspec-expectations (2.7.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.7.0)
-    sys-uname (0.9.0)
-      ffi (>= 1.0.0)
-    tzinfo (0.3.31)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  ZenTest (~> 4.6.2)
-  albino (~> 1.3.3)
-  autotest (~> 4.4.6)
-  autotest-fsevent (~> 0.2.8)
-  autotest-growl (~> 0.2.16)
-  awesome_print (~> 1.0.1)
-  bundler (>= 1.0.0)
-  faker (~> 0.9.5)
-  nokogiri (~> 1.4.6)
-  rake (~> 0.9.2.2)
-  redcarpet (~> 1.17.2)
-  rspec (~> 2.7.0)
-  thrillcall-api!
-  tzinfo (~> 0.3.31)

data/README.md

@@ -1,1389 +0,0 @@
-# Thrillcall API
-This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.
-
-# Ruby API Wrapper
-### Usage:
-
-``` ruby
-    #---------------------------------------------------------------#
-    # First, require the gem:
-    #---------------------------------------------------------------#
-    require 'rubygems'
-    require 'thrillcall-api'
-    
-    #---------------------------------------------------------------#
-    # Instantiate with your Thrillcall API key:
-    #---------------------------------------------------------------#
-    MY_API_KEY = "1234567890abcdef"
-    tc = ThrillcallAPI.new(MY_API_KEY)
-    
-    #---------------------------------------------------------------#
-    # Access any endpoint directly from the instance
-    #---------------------------------------------------------------#
-    # This is like calling GET "/events"
-    tc.events
-    # => [ {"id" => ... }, {...}, ...]
-    
-    #---------------------------------------------------------------#
-    # Provide IDs as arguments
-    #---------------------------------------------------------------#
-    # GET "/event/1"
-    tc.event(1)
-    # => {"id" => 1, ...}
-    
-    #---------------------------------------------------------------#
-    # Provide parameters as arguments
-    #---------------------------------------------------------------#
-    # GET "/events?limit=5"
-    events = tc.events(:limit => 5)
-    # => [ {"id" => ... }, {...}, ...]
-    events.length
-    # => 5
-    
-    #---------------------------------------------------------------#
-    # Chain methods together for nested routes
-    #---------------------------------------------------------------#
-    # GET "/search/venues/warfield?postalcode=94101&radius=20"
-    venues = tc.search.venues("warfield", :postalcode => "94101", :radius => 20)
-    # => [{"name" => "The Warfield", ...}]
-```
-
-### Advanced Usage:
-
-Provide additional instantiation options:
-
-``` ruby
-    
-    #---------------------------------------------------------------#
-    # The default SSL endpoint is "https://api.thrillcall.com/api/".
-    # The default API version is 3.
-    # By default, Faraday access logging is turned off.
-    # Override if necessary:
-    #---------------------------------------------------------------#
-    tc = ThrillcallAPI.new(
-      MY_API_KEY,
-      :base_url => "https://api.thrillcall.com/custom/",
-      :version  => 3,
-      :logger   => true
-    )
-    
-```
-
-Internally, the wrapper returns a ThrillcallAPI::Result class for any call.  Data for the request is fetched only when used.  This allows you to build requests piecemeal before executing them.
-
-``` ruby
-    
-    #---------------------------------------------------------------#
-    # Build a partial request, add on to it later
-    #---------------------------------------------------------------#
-    request = tc.artist(22210) # Lady Gaga
-    
-    # GET "/artist/22210/events?limit=2"
-    artist_events = request.events(:limit => 2)
-    
-    artist_events.length
-    # => 2
-    
-```
-
-This gem is a convenience wrapper around the excellent Faraday project.  If more complicated use cases are necessary, consider using Faraday directly.
-
-``` ruby
-    
-    require 'faraday'
-    require 'json'
-    
-    MY_API_KEY  = "1234567890abcdef"
-    BASE_URL    = "https://api.thrillcall.com/api/v3/"
-    HEADERS     = { :accept => 'application/json' }
-    
-    connection  = Faraday.new( :url => BASE_URL, :headers => HEADERS ) do |builder|
-      builder.adapter Faraday.default_adapter
-      builder.response :logger
-      builder.response :raise_error
-    end
-    
-    request = connection.get do |req|
-      req.url "artist/22210", { :api_key => MY_API_KEY }
-    end
-    
-    artist = JSON.parse(request.body)
-    
-    artist["name"]
-    # => "Lady Gaga"
-    
-```
-
-
-# HTTPS Endpoints
-
-### SSL/TLS Endpoints Required:
-All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443
-Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.
-
-### Parameters
-These are valid parameters for any endpoint, however, they will only be used by the server where applicable.
-
-**api\_key** MUST BE SUPPLIED for every endpoint.
-
-- <a name="api_key" />**api\_key** _string: (format: length == 16)_
-    
-    Your API key.  Required for access to any endpoint.
-    
-- <a name="limit" />**limit** _integer_
-    
-    _Default: 100_
-    
-    Sets the maximum number of results to return.  Cannot be above 200.
-    
-- <a name="page" />**page** _integer_
-    
-    _Default: 0_
-    
-    Used in conjunction with **[limit](#limit)**.
-    
-    Specifies the page number.  If limit is 10, then page = 2 will return results #20 through #29
-    
-- <a name="time_zone" />**time\_zone** _string (format: TZ Database string, eg "America/Los\_Angeles")_
-    
-    _Default: UTC_
-    _For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden._
-    
-    **[min\_date](#min_date)** and **[max\_date](#max_date)** will be calculated based on this time zone.
-    
-- <a name="min_date" />**min\_date** _string (format: "YYYY-MM-DD")_
-    
-    _Default: Today_
-    
-    Results before this date will not be returned.
-    
-- <a name="max_date" />**max\_date** _string (format: "YYYY-MM-DD")_
-    
-    _Default: 1 year from Today_
-    
-    Results after this date will not be returned.
-    
-- <a name="min_updated_at" />**min\_updated\_at** _string (format: "YYYY-MM-DD")_
-    
-    _Default: none_
-    
-    Results with updated_at columns before this date will not be returned.
-    
-- <a name="max_date" />**max\_updated\_at** _string (format: "YYYY-MM-DD")_
-  
-    _Default: none_
-    
-    Results with updated_at columns after this date will not be returned.
-    
-- <a name="lat" />**lat** _float_
-    
-    _Default: none_
-    
-    If latitude (**[lat](#lat)**) and longitude (**[long](#long)**) if both are specified, results will be within **[radius](#radius)** of this location.
-    
-    For Person queries, this specifies the latitude of the person's location.
-    
-- <a name="long" />**long** _float_
-    
-    _Default: none_
-    
-    If latitude (**[lat](#lat)**) and longitude (**[long](#long)**) if both are specified, results will be within **[radius](#radius)** of this location.
-    
-    For Person queries, this specifies the longitude of the person's location.
-    
-- <a name="postalcode" />**postalcode** _string (format: length >= 5)_
-    
-    _Default: none_
-    
-    Results will be within the **[radius](#radius)** of this postal code.
-    If latitude (**[lat](#lat)**) and longitude (**[long](#long)**) if both are specified, this will be ignored.
-    
-- <a name="radius" />**radius** _float_
-    
-    _Default: 100.0_
-    
-    Used in conjunction with **[postalcode](#postalcode)**
-    
-- <a name="use_partner_id" />**use\_partner\_id** _boolean_
-    
-    _Default: false_
-    
-    If set to _true_ or _1_, instead of using Thrillcall internal IDs, treat any IDs in a request as belonging to your partner definition.
-    
-    Contact us to set up a list of definitions.
-    
-- <a name="ticket_type" />**ticket\_type** _string (format: "primary" or "resale")_
-    
-    _Default: both_
-    
-    If specified, will only return tickets from Primary or Resale merchants.
-    
-- <a name="must_have_tickets" />**must\_have\_tickets** _boolean_
-    
-    _Default: false_
-    
-    If set to _true_ or _1_, will only return results that have tickets associated with them.
-    
-- <a name="show_disabled_events" />**show\_disabled\_events** _boolean_
-    
-    _Default: false_
-    
-    If set to _true_ or _1_, will not filter out events which have been disabled internally.
-    
-- <a name="show_unconfirmed_events" />**show\_unconfirmed\_events** _boolean_
-    
-    _Default: false_
-    
-    If set to _true_ or _1_, will not filter out events with unconfirmed locations.
-    
-- <a name="show_rumor_events" />**show\_rumor\_events** _boolean_
-    
-    _Default: false_
-    
-    If set to _true_ or _1_, will not filter out events marked as rumored.
-
-- <a name="primary_genre_id" />**primary\_genre\_id** _integer_
-    
-    _Default: none_
-    
-    If set, will filter Artist results to only those with the specified **[primary\_genre\_id](#primary_genre_id)**
-
-- <a name="email" />**email** _string_
-    
-    The email address associated with a user, required for registration.
-
-- <a name="password" />**password** _string (format: 40 >= length >= 5)_
-    
-    The user's password.  Must be supplied along with **[email](#email)** unless using **[provider](#provider)** / **[uid](#uid)** / **[token](#token)** auth.
-
-- <a name="provider" />**provider** _string_
-    
-    The name of the authentication provider (e.g. "facebook").  Must be supplied along with **[uid](#uid)** and **[token](#token)** unless using **[email](#email)**/**[password](#password)** auth.
-
-- <a name="uid" />**uid** _string_
-    
-    The user's ID with **[provider](#provider)**.  Must be supplied along with **[provider](#provider)** and **[token](#token)** unless using **[email](#email)**/**[password](#password)** auth.
-
-- <a name="token" />**token** _string_
-    
-    The user's authentication token with **[provider](#provider)**.  Must be supplied along with **[provider](#provider)** and **[uid](#uid)** unless using **[email](#email)**/**[password](#password)** auth.
-
-- <a name="first_name" />**first\_name** _string (format: 50 >= length >= 2)_
-    
-    Required to register a user.
-
-- <a name="last_name" />**last\_name** _string (format: 50 >= length >= 2)_
-    
-    Optional for registering a user.
-
-- <a name="gender" />**gender** _string (format: length == 1)_
-    
-    Optional for registering a user.
-
-- <a name="location_name" />**location\_name** _string (format: "City, ST or City, State", length > 0))_
-    
-    The name of the user's location when auto-registering.  Either this or **[lat](#lat)** / **[long](#long)** must be provided.
-
-- <a name="referral_code" />**referral\_code** _string_
-    
-    The referral code to be used during registration.  Both the owner of the code as well as the new user will receive a referral credit point.
-
-
-## Artists
-Fields:
-
-- **created\_at**             _string_    ISO 8601 representation the time this object was created
-- **genre\_tags**             _string_    Semicolon separated list of Genre names
-- **id**                      _integer_   Thrillcall ID
-- **name**                    _string_    Artist / Band Name
-- **primary\_genre\_id**      _integer_   The Thrillcall ID for this artist's primary Genre
-- **upcoming\_events\_count** _integer_   Number of upcoming events associated with this object
-- **updated\_at**             _string_    ISO 8601 representation of last time this object was updated
-- **photos**                  _hash_      A hash of image urls of the primary photo available for this object in different styles
-- **url**                     _string_    URL for this object on Thrillcall
-
-
-### GET /artists
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[primary\_genre\_id](#primary_genre_id)**
-
-Returns:  _Array_ of Artists _Hash_
-
-``` js
-    // Example: GET /api/v3/artists?limit=14&api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2008-04-29T10:19:45Z",
-        "genre_tags": "O",
-        "id": 1,
-        "name": "Hyler Jones Proteges",
-        "primary_genre_id": 61,
-        "upcoming_events_count": 0,
-        "updated_at": "2010-03-26T16:49:20Z",
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
-          "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
-          "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
-          "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
-        },
-        "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /artist/:id
-**:id** _integer_  Thrillcall or Partner ID
-
-Params:
-
-- **[use\_partner\_id](#use_partner_id)**
-
-Returns:  Artist _Hash_
-
-``` js
-    // Example: GET /api/v3/artist/378465?api_key=1234567890abcdef
-    
-    {
-      "created_at": "2011-05-19T20:27:47Z",
-      "genre_tags": "Operatic pop",
-      "id": 378465,
-      "name": "Il Volo",
-      "primary_genre_id": 61,
-      "upcoming_events_count": 30,
-      "updated_at": "2012-03-27T15:59:04Z",
-      "photos": {
-        "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-        "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
-        "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-        "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-      },
-      "url": "http://thrillcall.com/artist/Il_Volo"
-    }
-```
-
-### GET /artist/:id/events
-**:id** _integer_  Thrillcall or Partner ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[time\_zone](#time_zone)**
-- **[min\_date](#min_date)**
-- **[max\_date](#max_date)**
-- **[min\_updated\_at](#min_updated_at)**
-- **[max\_updated\_at](#max_updated_at)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[postalcode](#postalcode)**
-- **[radius](#radius)**
-- **[use\_partner\_id](#use_partner_id)**
-- **[ticket\_type](#ticket_type)**
-- **[must\_have\_tickets](#must_have_tickets)**
-- **[show\_disabled\_events](#show_disabled_events)**
-- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
-- **[show\_rumor\_events](#show_rumor_events)**
-
-Returns:  _Array_ of Events _Hash_
-
-``` js
-    // Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2012-03-02T08:01:03Z",
-        "festival": false,
-        "id": 1046915,
-        "latitude": 47.6136,
-        "longitude": -122.332,
-        "name": "Il Volo @ Paramount Theatre - Seattle",
-        "on_sale_date": null,
-        "rumor": false,
-        "start_date": "2012-10-02T19:30:00Z",
-        "starts_at": "2012-10-03T02:30:00Z",
-        "starts_at_time_trusted": true,
-        "unconfirmed_location": 0,
-        "updated_at": "2012-03-29T01:35:53Z",
-        "venue_id": 61705,
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-        },
-        "url": "http://thrillcall.com/event/1046915",
-        "starts_at_local": "2012-10-02T19:30:00-07:00",
-        "time_zone": "America/Los_Angeles",
-        "status": "confirmed"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /search/artists/:term
-**:term** _string_  Arbitrary search string on the **name** field.  (alphanumerics only, underscore matches underscore, use '+' for space)
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-
-Returns:  _Array_ of Artists _Hash_
-
-``` js
-    // Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2011-05-19T20:27:47Z",
-        "genre_tags": "Operatic pop",
-        "id": 378465,
-        "name": "Il Volo",
-        "primary_genre_id": 61,
-        "upcoming_events_count": 30,
-        "updated_at": "2012-03-27T15:59:04Z",
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-          "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
-          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-        },
-        "url": "http://thrillcall.com/artist/Il_Volo"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-## Events
-Fields:
-
-- **created\_at**                 _string_  ISO 8601 representation the time this object was created
-- **festival**                    _boolean_ Is this event a festival?
-- **id**                          _integer_ Thrillcall ID
-- **latitude**                    _float_   Approximate latitude for the Event
-- **longitude**                   _float_   Approximate longitude for the Event
-- **name**                        _string_  Name of the Event
-- **on\_sale\_date**              _string_  ISO 8601 representation of the date when tickets go on sale
-- **rumor**                       _boolean_ Are the details for this event based on a rumor?
-- **status**                      _string_  Status of the event (confirmed, unconfirmed, cancelled, or disabled)
-- **starts\_at**                  _string_  ISO 8601 representation of the start of the Event in UTC time
-- **starts\_at\_local**           _string_  ISO 8601 representation of the start of the Event in the local timezone
-- **starts\_at\_time\_trusted**   _boolean_ Do we trust that the time of day component of **starts\_at** is valid?
-- **time\_zone**                  _string_  TZ Database string representing the time zone at the location of the event
-- **unconfirmed\_location**       _integer_ If 1, the location of this event is unconfirmed
-- **updated\_at**                 _string_  ISO 8601 representation of last time this object was updated
-- **venue\_id**                   _integer_ Thrillcall Venue ID
-- **photos**                      _hash_    A hash of image urls of the primary photo available for this object in different styles
-- **url**                         _string_  URL for this object on Thrillcall
-
-
-### GET /events
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[time\_zone](#time_zone)**
-- **[min\_date](#min_date)**
-- **[max\_date](#max_date)**
-- **[min\_updated\_at](#min_updated_at)**
-- **[max\_updated\_at](#max_updated_at)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[postalcode](#postalcode)**
-- **[radius](#radius)**
-- **[ticket\_type](#ticket_type)**
-- **[must\_have\_tickets](#must_have_tickets)**
-- **[show\_disabled\_events](#show_disabled_events)**
-- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
-- **[show\_rumor\_events](#show_rumor_events)**
-
-Returns:  _Array_ of Events _Hash_
-
-``` js
-    // Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2012-03-02T18:06:14Z",
-        "festival": false,
-        "id": 1047075,
-        "latitude": 37.7915,
-        "longitude": -122.413,
-        "name": "Il Volo @ Masonic Center",
-        "on_sale_date": null,
-        "rumor": false,
-        "start_date": "2012-09-29T19:30:04Z",
-        "starts_at": "2012-09-30T02:30:04Z",
-        "starts_at_time_trusted": true,
-        "unconfirmed_location": 0,
-        "updated_at": "2012-03-29T01:35:57Z",
-        "venue_id": 63279,
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-        },
-        "url": "http://thrillcall.com/event/1047075",
-        "starts_at_local": "2012-09-29T19:30:04-07:00",
-        "time_zone": "America/Los_Angeles"
-        "status": "confirmed"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /event/:id
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- None
-
-Returns:  Event _Hash_
-
-``` js
-    // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
-    
-    {
-      "address1": "1111 California Street",
-      "address2": null,
-      "city": "San Francisco",
-      "country": "US",
-      "created_at": "2009-08-25T19:25:27Z",
-      "id": 63279,
-      "latitude": 37.79153,
-      "long_description": null,
-      "longitude": -122.412757,
-      "name": "Masonic Center",
-      "phone_number": null,
-      "state": "CA",
-      "time_zone": "America/Los_Angeles",
-      "upcoming_events_count": 4,
-      "updated_at": "2012-04-04T02:08:50Z",
-      "postalcode": "94108",
-      "photos": {
-        "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
-        "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
-        "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
-        "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
-      },
-      "metro_area_id": 105,
-      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
-    }
-```
-
-### GET /event/:id/artists
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-
-Returns:  _Array_ of Artists _Hash_
-
-``` js
-    // Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2011-05-19T20:27:47Z",
-        "genre_tags": "Operatic pop",
-        "id": 378465,
-        "name": "Il Volo",
-        "primary_genre_id": 61,
-        "upcoming_events_count": 30,
-        "updated_at": "2012-03-27T15:59:04Z",
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-          "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
-          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-        },
-        "url": "http://thrillcall.com/artist/Il_Volo"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /event/:id/venue
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- None
-
-Returns:  Venue _Hash_
-
-``` js
-    // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
-    
-    {
-      "address1": "1111 California Street",
-      "address2": null,
-      "city": "San Francisco",
-      "country": "US",
-      "created_at": "2009-08-25T19:25:27Z",
-      "id": 63279,
-      "latitude": 37.79153,
-      "long_description": null,
-      "longitude": -122.412757,
-      "name": "Masonic Center",
-      "phone_number": null,
-      "state": "CA",
-      "time_zone": "America/Los_Angeles",
-      "upcoming_events_count": 4,
-      "updated_at": "2012-04-04T02:08:50Z",
-      "postalcode": "94108",
-      "photos": {
-        "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
-        "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
-        "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
-        "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
-      },
-      "metro_area_id": 105,
-      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
-    }
-```
-
-### GET /event/:id/tickets
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[ticket\_type](#ticket_type)**
-
-Returns:  _Array_ of Tickets _Hash_
-
-``` js
-    // Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2012-03-02T18:06:14Z",
-        "description": null,
-        "event_id": 1047075,
-        "id": 819883,
-        "marketing_text": null,
-        "max_ticket_price": 85,
-        "min_ticket_price": 29,
-        "name": "Onsale to General Public",
-        "on_sale_end_date": null,
-        "on_sale_start_date": null,
-        "seat_info": null,
-        "updated_at": "2012-03-02T18:06:14Z",
-        "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-## Genre
-Fields:
-
-- **created\_at**             _string_    ISO 8601 representation the time this object was created
-- **description**             _string_    Description of the Genre
-- **id**                      _integer_   Thrillcall ID
-- **name**                    _string_    Name of the Genre
-- **updated\_at**             _string_    ISO 8601 representation of last time this object was updated
-
-### GET /genres
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-
-Returns:  _Array_ of Genres _Hash_
-
-``` js
-    // Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2008-07-09T19:17:45Z",
-        "description": "Shawn Colvin, Loudon Wainwright III etc...",
-        "id": 6,
-        "name": "Folk",
-        "updated_at": "2010-03-25T23:51:55Z"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /genre/:id
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- None
-
-Returns: Genre _Hash_
-
-``` js
-    // Example: GET /api/v3/genre/27?api_key=1234567890abcdef
-    
-    {
-      "created_at": "2008-07-09T19:17:45Z",
-      "description": "U2, 30 Seconds To Mars etc...",
-      "id": 27,
-      "name": "Rock",
-      "updated_at": "2010-03-25T23:52:21Z"
-    }
-```
-
-### GET /genre/:id/artists
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-
-Returns:  _Array_ of Artists _Hash_
-
-``` js
-    // Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2008-04-29T10:19:45Z",
-        "genre_tags": "O",
-        "id": 1,
-        "name": "Hyler Jones Proteges",
-        "primary_genre_id": 61,
-        "upcoming_events_count": 0,
-        "updated_at": "2010-03-26T16:49:20Z",
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
-          "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
-          "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
-          "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
-        },
-        "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-## Metro Area
-Fields:
-
-- **city**                                _string_    City of the Metro Area
-- **country**                             _string_    Country of the Metro Area
-- **created\_at**                         _string_    ISO 8601 representation the time this object was created
-- **id**                                  _integer_   Thrillcall ID
-- **latitude**                            _float_     Latitude of the Metro Area
-- **longitude**                           _float_     Longitude of the Metro Area
-- **radius**                              _integer_   Radius of the Metro Area from the Lat/Long center
-- **state**                               _string_    State of the Metro Area
-- **time\_zone**                          _string_    Time zone of the Metro Area
-- **updated\_at**                         _string_    ISO 8601 representation of last time this object was updated
-- **url**                                 _string_    URL for this object on Thrillcall
-- **offers\_availability\_status\_code**  _integer_   Offers status for the Metro Area ( no\_offers = 0, available = 1, coming\_soon = 2)
-
-### GET /metro_areas
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-
-Returns:  _Array_ of Metro Areas _Hash_
-
-``` js
-    // Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef
-    
-    [
-      {
-        "city": "Chicago",
-        "country": "US",
-        "created_at": "2011-06-24T03:23:57Z",
-        "id": 104,
-        "latitude": 41.8842,
-        "longitude": -87.6324,
-        "offers_availability_status_code": 1,
-        "radius": 50,
-        "state": "IL",
-        "time_zone": "America/Chicago",
-        "updated_at": "2011-12-27T00:44:37Z",
-        "url": "http://thrillcall.com/live-music/chicago"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /metro_area/:id
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- None
-
-Returns:  Metro Area _Hash_
-
-``` js
-    // Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef
-    
-    {
-      "city": "San Francisco",
-      "country": "US",
-      "created_at": "2011-06-24T03:23:57Z",
-      "id": 105,
-      "latitude": 37.7771,
-      "longitude": -122.42,
-      "offers_availability_status_code": 1,
-      "radius": 50,
-      "state": "CA",
-      "time_zone": "America/Los_Angeles",
-      "updated_at": "2011-12-27T00:44:37Z",
-      "url": "http://thrillcall.com/live-music/san-francisco"
-    }
-```
-
-### GET /metro_area/:id/events
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[min\_date](#min_date)**
-- **[max\_date](#max_date)**
-- **[min\_updated\_at](#min_updated_at)**
-- **[max\_updated\_at](#max_updated_at)**
-- **[radius](#radius)**
-- **[ticket\_type](#ticket_type)**
-- **[must\_have\_tickets](#must_have_tickets)**
-- **[show\_disabled\_events](#show_disabled_events)**
-- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
-- **[show\_rumor\_events](#show_rumor_events)**
-
-Note:  Time Zone is set as the time zone of the Metro Area and cannot be overridden.
-
-Returns:  _Array_ of Metro Areas _Hash_
-
-``` js
-    // Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&max_date=2012-04-04&limit=3&api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2012-01-02T08:53:00Z",
-        "festival": false,
-        "id": 1011386,
-        "latitude": 37.7771,
-        "longitude": -122.42,
-        "name": "Kontrol @ The End Up",
-        "on_sale_date": null,
-        "rumor": false,
-        "start_date": "2012-01-07T00:00:04Z",
-        "starts_at": "2012-01-07T08:00:04Z",
-        "starts_at_time_trusted": false,
-        "unconfirmed_location": 0,
-        "updated_at": "2012-03-29T01:19:31Z",
-        "venue_id": 47273,
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/event/_default/default-thumbnail.jpg",
-          "large": "http://i.development.tc-core.com/event/_default/default-large.jpg",
-          "mobile": "http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
-        },
-        "url": "http://thrillcall.com/event/1011386",
-        "starts_at_local": "2012-01-07T00:00:04-08:00",
-        "time_zone": "America/Los_Angeles"
-        "status": "confirmed"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-## Person
-**Note:** Your API key requires the api\_auth permission to access the endpoints associated with this object.
-
-Fields:
-
-- **created\_at**             _string_    ISO 8601 representation the time this object was created
-- **first\_name**             _string_    First name of the Person
-- **gender**                  _string_    Gender of the Person
-- **id**                      _integer_   Thrillcall ID
-- **last\_name**              _string_    Last name of the Person
-- **login**                   _string_    Login (Email Address) of the Person
-- **updated\_at**             _string_    ISO 8601 representation of last time this object was updated
-- **referral\_code**          _string_    Referral code of the Person
-- **referral\_credits**       _integer_   Number of Referral credits the Person has (including bonus points)
-- **postalcode**              _string_    Postalcode of the Person
-- **photos**                  _hash_      A hash of image urls of the primary photo available for this object in different styles
-
-### GET /person/:id
-Params:
-
-- None.
-
-Returns: Person _Hash_
-
-``` js
-    // Example: GET /api/v3/person/49?api_key=1234567890abcdef
-    
-    {
-      "address1": null,
-      "address2": null,
-      "city": "Santa Rosa",
-      "country_code": "US",
-      "created_at": "2011-10-17T18:54:31Z",
-      "first_name": "John",
-      "gender": "m",
-      "id": 49,
-      "last_name": "Doe",
-      "login": "bogus@bogus.com",
-      "state": "CA",
-      "time_zone": "America/Los_Angeles",
-      "timezone": "-7",
-      "updated_at": "2012-03-28T16:07:16Z",
-      "referral_code": null,
-      "referral_credits": 0,
-      "postalcode": "95407",
-      "photos": {
-        "small_thumb": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
-        "thumbnail": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
-        "medium": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"
-      }
-    }
-```
-
-### POST /person/signin
-Params:
-
-- **[email](#email)**
-- **[password](#password)**
-- **[provider](#provider)**
-- **[uid](#uid)**
-- **[token](#token)**
-- **[first\_name](#first_name)**
-- **[last\_name](#last_name)**
-- **[location\_name](#location_name)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[referral\_code](#referral_code)**
-
-Use either **[email](#email)** / **[password](#password)** or **[provider](#provider)** / **[uid](#uid)** / **[token](#token)**.
-
-May perform registration ("signup") automatically if using **[provider](#provider)** / **[uid](#uid)** / **[token](#token)** when no match is found and name, location, and **[referral_code](#referral_code)** are also provided.
-
-Returns: Person _Hash_
-
-``` js
-    // Example: POST /api/v3/person/signin?provider=facebook&uid=123123bogus&token=123123bogus&email=123123bogus%40bogus.com&first_name=Mister&last_name=Bogus&lat=38.5&long=-123.0&api_key=1234567890abcdef
-    
-    {
-      "address1": null,
-      "address2": null,
-      "city": null,
-      "country_code": null,
-      "created_at": null,
-      "first_name": "Mister",
-      "gender": null,
-      "last_name": "Bogus",
-      "login": null,
-      "state": null,
-      "time_zone": null,
-      "timezone": null,
-      "updated_at": null,
-      "referral_code": null,
-      "referral_credits": 0,
-      "postalcode": null,
-      "photos": {
-        "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
-        "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
-        "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
-      }
-    }
-```
-
-### POST /person/signup
-Params:
-
-- **[first\_name](#first_name)**
-- **[last\_name](#last_name)**
-- **[gender](#gender)**
-- **[email](#email)**
-- **[password](#password)**
-- **[postalcode](#postalcode)**
-- **[referral\_code](#referral_code)**
-
-Returns: Person _Hash_
-
-``` js
-    // Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef
-    
-    {
-      "address1": null,
-      "address2": null,
-      "city": null,
-      "country_code": null,
-      "created_at": null,
-      "first_name": "Mister",
-      "gender": null,
-      "last_name": null,
-      "login": null,
-      "state": null,
-      "time_zone": null,
-      "timezone": null,
-      "updated_at": null,
-      "referral_code": null,
-      "referral_credits": 0,
-      "postalcode": null,
-      "photos": {
-        "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
-        "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
-        "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
-      }
-    }
-```
-
-
-## Venues
-Fields:
-
-- **address1**                _string_    First address field for the Venue
-- **address2**                _string_    Second address field for the Venue
-- **city**                    _string_    City the Venue is in
-- **country**                 _string_    Country the Venue is in
-- **created\_at**             _string_    ISO 8601 representation the time this object was created
-- **id**                      _integer_   Thrillcall ID
-- **latitude**                _float_     Approximate Latitude for the Venue
-- **long\_description**       _text_      Description of the Venue
-- **longitude**               _float_     Approximate Longitude for the Venue
-- **name**                    _string_    Name of the Venue
-- **metro\_area\_id**         _integer_   Thrillcall ID of the Metro Area this Venue is in, if any
-- **state**                   _string_    State the Venue is in
-- **upcoming\_events\_count** _integer_   Number of upcoming events associated with this object
-- **updated\_at**             _string_    ISO 8601 representation of last time this object was updated
-- **postalcode**              _string_    Postal code for the Venue
-- **phone\_number**           _string_    Phone number for the Venue (including country code)
-- **photos**                  _hash_      A hash of image urls of the primary photo available for this object in different styles
-- **url**                     _string_    URL for this object on Thrillcall
-
-
-### GET /venues
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[postalcode](#postalcode)**
-- **[radius](#radius)**
-
-Returns:  _Array_ of Venues _Hash_
-
-``` js
-    // Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef
-    
-    [
-      {
-        "address1": null,
-        "address2": null,
-        "city": "Guadalajara",
-        "country": "MX",
-        "created_at": "2008-05-09T09:29:23Z",
-        "id": 1,
-        "latitude": 20.666222,
-        "long_description": null,
-        "longitude": -103.352089,
-        "name": "Fbolko",
-        "phone_number": null,
-        "state": "MX",
-        "time_zone": "America/Mexico_City",
-        "upcoming_events_count": 0,
-        "updated_at": "2012-03-29T00:04:23Z",
-        "postalcode": null,
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
-          "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
-          "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
-          "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
-        },
-        "metro_area_id": null,
-        "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-
-### GET /venue/:id
-**:id** _integer_  Thrillcall or Partner ID
-
-Params:
-
-- **[use\_partner\_id](#use_partner_id)**
-
-Returns:  Venue _Hash_
-
-``` js
-    // Example: GET /api/v3/venue/51886?api_key=1234567890abcdef
-    
-    {
-      "address1": "201 Van Ness Avenue",
-      "address2": null,
-      "city": "San Francisco",
-      "country": "US",
-      "created_at": "2008-04-28T17:59:32Z",
-      "id": 51886,
-      "latitude": 37.777402,
-      "long_description": null,
-      "longitude": -122.419815,
-      "name": "Davies Symphony Hall",
-      "phone_number": "(415) 864-6000",
-      "state": "CA",
-      "time_zone": "America/Los_Angeles",
-      "upcoming_events_count": 48,
-      "updated_at": "2012-03-28T03:13:27Z",
-      "postalcode": "94102",
-      "photos": {
-        "thumbnail": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
-        "medium": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
-        "large": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
-        "mobile": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
-      },
-      "metro_area_id": 105,
-      "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
-    }
-```
-
-### GET /venue/:id/events
-**:id** _integer_  Thrillcall or Partner ID
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[time\_zone](#time_zone)**
-- **[min\_date](#min_date)**
-- **[max\_date](#max_date)**
-- **[min\_updated\_at](#min_updated_at)**
-- **[max\_updated\_at](#max_updated_at)**
-- **[use\_partner\_id](#use_partner_id)**
-- **[ticket\_type](#ticket_type)**
-- **[must\_have\_tickets](#must_have_tickets)**
-- **[show\_disabled\_events](#show_disabled_events)**
-- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
-- **[show\_rumor\_events](#show_rumor_events)**
-
-Returns:  _Array_ of Events _Hash_
-
-``` js
-    // Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2012-03-02T18:06:14Z",
-        "festival": false,
-        "id": 1047075,
-        "latitude": 37.7915,
-        "longitude": -122.413,
-        "name": "Il Volo @ Masonic Center",
-        "on_sale_date": null,
-        "rumor": false,
-        "start_date": "2012-09-29T19:30:04Z",
-        "starts_at": "2012-09-30T02:30:04Z",
-        "starts_at_time_trusted": true,
-        "unconfirmed_location": 0,
-        "updated_at": "2012-03-29T01:35:57Z",
-        "venue_id": 63279,
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
-          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
-          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
-        },
-        "url": "http://thrillcall.com/event/1047075",
-        "starts_at_local": "2012-09-29T19:30:04-07:00",
-        "time_zone": "America/Los_Angeles"
-        "status": "confirmed"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /search/venues/:term
-**:term** _string_  Arbitrary search string on the **name** field.  (alphanumerics only, underscore matches underscore, use '+' for space)
-
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[postalcode](#postalcode)**
-- **[radius](#radius)**
-
-Returns:  _Array_ of Venues _Hash_
-
-``` js
-    // Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef
-    
-    [
-      {
-        "address1": "525 W Riverview Ave",
-        "address2": null,
-        "city": "Dayton",
-        "country": "US",
-        "created_at": "2008-06-12T14:12:53Z",
-        "id": 33642,
-        "latitude": 39.765526,
-        "long_description": null,
-        "longitude": -84.203133,
-        "name": "Dayton Masonic Center",
-        "phone_number": null,
-        "state": "OH",
-        "time_zone": "America/New_York",
-        "upcoming_events_count": 0,
-        "updated_at": "2012-03-28T03:11:49Z",
-        "postalcode": "45405",
-        "photos": {
-          "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
-          "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
-          "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
-          "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
-        },
-        "metro_area_id": 134,
-        "url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-## Tickets
-Fields:
-
-- **created\_at**            _string_   ISO 8601 representation the time this object was created
-- **description**            _string_   Long form description of the ticket
-- **event\_id**              _integer_  Thrillcall Event ID
-- **id**                     _integer_  Thrillcall ID
-- **marketing\_text**        _string_   Long form description of the ticket
-- **max\_ticket\_price**     _float_    Maximum price for this ticket
-- **min\_ticket\_price**     _float_    Minimum price for this ticket
-- **name**                   _string_   Name of this ticket
-- **on\_sale\_end\_date**    _string_   YYYY-MM-DD date when the ticket goes off sale
-- **on\_sale\_start\_date**  _string_   YYYY-MM-DD date when the ticket goes on sale
-- **seat\_info**             _string_   Additional info about the seat
-- **updated\_at**            _string_   ISO 8601 representation of last time this object was updated
-- **url**                    _string_   URL for this object on Thrillcall
-
-### GET /tickets
-Params:
-
-- **[limit](#limit)**
-- **[page](#page)**
-- **[time\_zone](#time_zone)**
-- **[min\_date](#min_date)**
-- **[max\_date](#max_date)**
-- **[min\_updated\_at](#min_updated_at)**
-- **[max\_updated\_at](#max_updated_at)**
-- **[lat](#lat)**
-- **[long](#long)**
-- **[postalcode](#postalcode)**
-- **[radius](#radius)**
-- **[ticket\_type](#ticket_type)**
-- **[show\_disabled\_events](#show_disabled_events)**
-- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
-- **[show\_rumor\_events](#show_rumor_events)**
-
-Returns:  _Array_ of Tickets _Hash_
-
-``` js
-    // Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef
-    
-    [
-      {
-        "created_at": "2008-12-06T00:19:59Z",
-        "description": null,
-        "event_id": 455646,
-        "id": 1,
-        "marketing_text": null,
-        "max_ticket_price": null,
-        "min_ticket_price": null,
-        "name": "General Onsale",
-        "on_sale_end_date": null,
-        "on_sale_start_date": null,
-        "seat_info": null,
-        "updated_at": "2009-09-22T22:58:37Z",
-        "url": "http://www.livenation.com/edp/eventId/335800/?c=api-000157"
-      },
-      {
-        ...
-      },
-      ...
-    ]
-```
-
-### GET /ticket/:id
-**:id** _integer_  Thrillcall ID
-
-Params:
-
-- None
-
-Returns:  Ticket _Hash_
-
-``` js
-    // Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef
-    
-    {
-      "created_at": "2012-03-02T18:06:14Z",
-      "description": null,
-      "event_id": 1047075,
-      "id": 819883,
-      "marketing_text": null,
-      "max_ticket_price": 85,
-      "min_ticket_price": 29,
-      "name": "Onsale to General Public",
-      "on_sale_end_date": null,
-      "on_sale_start_date": null,
-      "seat_info": null,
-      "updated_at": "2012-03-02T18:06:14Z",
-      "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
-    }
-```