thrillcall-api 0.0.6 → 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (22) hide show
  1. data/lib/thrillcall-api.rb +50 -4
  2. data/lib/thrillcall-api/result.rb +6 -2
  3. data/lib/thrillcall-api/version.rb +1 -1
  4. metadata +25 -24
  5. data/.autotest +0 -10
  6. data/.gitignore +0 -10
  7. data/.rspec +0 -4
  8. data/.rvmrc +0 -2
  9. data/Gemfile +0 -4
  10. data/Gemfile.lock +0 -64
  11. data/README.md +0 -1389
  12. data/Rakefile +0 -12
  13. data/autotest/discover.rb +0 -1
  14. data/docs/API.html +0 -1526
  15. data/docs/API.md +0 -1272
  16. data/docs/README.html +0 -1646
  17. data/docs/WRAPPER.html +0 -182
  18. data/docs/WRAPPER.md +0 -115
  19. data/script/convert_readme.rb +0 -119
  20. data/spec/spec_helper.rb +0 -11
  21. data/spec/thrillcall-api/thrillcall-api_spec.rb +0 -688
  22. data/thrillcall-api.gemspec +0 -36
data/docs/README.html DELETED
@@ -1,1646 +0,0 @@
1
-
2
- <style type="text/css">
3
- .highlight .hll { background-color: #ffffcc }
4
- .highlight { background: #dddddd; }
5
- .highlight .c { color: #408080; font-style: italic } /* Comment */
6
- .highlight .err { border: 1px solid #FF0000 } /* Error */
7
- .highlight .k { color: #008000; font-weight: bold } /* Keyword */
8
- .highlight .o { color: #666666 } /* Operator */
9
- .highlight .cm { color: #408080; font-style: italic } /* Comment.Multiline */
10
- .highlight .cp { color: #BC7A00 } /* Comment.Preproc */
11
- .highlight .c1 { color: #408080; font-style: italic } /* Comment.Single */
12
- .highlight .cs { color: #408080; font-style: italic } /* Comment.Special */
13
- .highlight .gd { color: #A00000 } /* Generic.Deleted */
14
- .highlight .ge { font-style: italic } /* Generic.Emph */
15
- .highlight .gr { color: #FF0000 } /* Generic.Error */
16
- .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
17
- .highlight .gi { color: #00A000 } /* Generic.Inserted */
18
- .highlight .go { color: #808080 } /* Generic.Output */
19
- .highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
20
- .highlight .gs { font-weight: bold } /* Generic.Strong */
21
- .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
22
- .highlight .gt { color: #0040D0 } /* Generic.Traceback */
23
- .highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
24
- .highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
25
- .highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
26
- .highlight .kp { color: #008000 } /* Keyword.Pseudo */
27
- .highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
28
- .highlight .kt { color: #B00040 } /* Keyword.Type */
29
- .highlight .m { color: #666666 } /* Literal.Number */
30
- .highlight .s { color: #BA2121 } /* Literal.String */
31
- .highlight .na { color: #7D9029 } /* Name.Attribute */
32
- .highlight .nb { color: #008000 } /* Name.Builtin */
33
- .highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */
34
- .highlight .no { color: #880000 } /* Name.Constant */
35
- .highlight .nd { color: #AA22FF } /* Name.Decorator */
36
- .highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */
37
- .highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */
38
- .highlight .nf { color: #0000FF } /* Name.Function */
39
- .highlight .nl { color: #A0A000 } /* Name.Label */
40
- .highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
41
- .highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */
42
- .highlight .nv { color: #19177C } /* Name.Variable */
43
- .highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
44
- .highlight .w { color: #bbbbbb } /* Text.Whitespace */
45
- .highlight .mf { color: #666666 } /* Literal.Number.Float */
46
- .highlight .mh { color: #666666 } /* Literal.Number.Hex */
47
- .highlight .mi { color: #666666 } /* Literal.Number.Integer */
48
- .highlight .mo { color: #666666 } /* Literal.Number.Oct */
49
- .highlight .sb { color: #BA2121 } /* Literal.String.Backtick */
50
- .highlight .sc { color: #BA2121 } /* Literal.String.Char */
51
- .highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
52
- .highlight .s2 { color: #BA2121 } /* Literal.String.Double */
53
- .highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
54
- .highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */
55
- .highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
56
- .highlight .sx { color: #008000 } /* Literal.String.Other */
57
- .highlight .sr { color: #BB6688 } /* Literal.String.Regex */
58
- .highlight .s1 { color: #BA2121 } /* Literal.String.Single */
59
- .highlight .ss { color: #19177C } /* Literal.String.Symbol */
60
- .highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */
61
- .highlight .vc { color: #19177C } /* Name.Variable.Class */
62
- .highlight .vg { color: #19177C } /* Name.Variable.Global */
63
- .highlight .vi { color: #19177C } /* Name.Variable.Instance */
64
- .highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
65
- </style><h1>Thrillcall API</h1>
66
-
67
- <p>This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.</p>
68
-
69
- <h1>Ruby API Wrapper</h1>
70
-
71
- <h3>Usage:</h3>
72
-
73
- <div class="highlight">
74
- <pre> <span class="c1">#---------------------------------------------------------------#</span>
75
- <span class="c1"># First, require the gem:</span>
76
- <span class="c1">#---------------------------------------------------------------#</span>
77
- <span class="nb">require</span> <span class="s1">'rubygems'</span>
78
- <span class="nb">require</span> <span class="s1">'thrillcall-api'</span>
79
-
80
- <span class="c1">#---------------------------------------------------------------#</span>
81
- <span class="c1"># Instantiate with your Thrillcall API key:</span>
82
- <span class="c1">#---------------------------------------------------------------#</span>
83
- <span class="no">MY_API_KEY</span> <span class="o">=</span> <span class="s2">"1234567890abcdef"</span>
84
- <span class="n">tc</span> <span class="o">=</span> <span class="no">ThrillcallAPI</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="no">MY_API_KEY</span><span class="p">)</span>
85
-
86
- <span class="c1">#---------------------------------------------------------------#</span>
87
- <span class="c1"># Access any endpoint directly from the instance</span>
88
- <span class="c1">#---------------------------------------------------------------#</span>
89
- <span class="c1"># This is like calling GET "/events"</span>
90
- <span class="n">tc</span><span class="o">.</span><span class="n">events</span>
91
- <span class="c1"># =&gt; [ {"id" =&gt; ... }, {...}, ...]</span>
92
-
93
- <span class="c1">#---------------------------------------------------------------#</span>
94
- <span class="c1"># Provide IDs as arguments</span>
95
- <span class="c1">#---------------------------------------------------------------#</span>
96
- <span class="c1"># GET "/event/1"</span>
97
- <span class="n">tc</span><span class="o">.</span><span class="n">event</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
98
- <span class="c1"># =&gt; {"id" =&gt; 1, ...}</span>
99
-
100
- <span class="c1">#---------------------------------------------------------------#</span>
101
- <span class="c1"># Provide parameters as arguments</span>
102
- <span class="c1">#---------------------------------------------------------------#</span>
103
- <span class="c1"># GET "/events?limit=5"</span>
104
- <span class="n">events</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">events</span><span class="p">(</span><span class="ss">:limit</span> <span class="o">=&gt;</span> <span class="mi">5</span><span class="p">)</span>
105
- <span class="c1"># =&gt; [ {"id" =&gt; ... }, {...}, ...]</span>
106
- <span class="n">events</span><span class="o">.</span><span class="n">length</span>
107
- <span class="c1"># =&gt; 5</span>
108
-
109
- <span class="c1">#---------------------------------------------------------------#</span>
110
- <span class="c1"># Chain methods together for nested routes</span>
111
- <span class="c1">#---------------------------------------------------------------#</span>
112
- <span class="c1"># GET "/search/venues/warfield?postalcode=94101&amp;radius=20"</span>
113
- <span class="n">venues</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">search</span><span class="o">.</span><span class="n">venues</span><span class="p">(</span><span class="s2">"warfield"</span><span class="p">,</span> <span class="ss">:postalcode</span> <span class="o">=&gt;</span> <span class="s2">"94101"</span><span class="p">,</span> <span class="ss">:radius</span> <span class="o">=&gt;</span> <span class="mi">20</span><span class="p">)</span>
114
- <span class="c1"># =&gt; [{"name" =&gt; "The Warfield", ...}]</span>
115
- </pre>
116
- </div>
117
-
118
-
119
- <h3>Advanced Usage:</h3>
120
-
121
- <p>Provide additional instantiation options:</p>
122
-
123
- <div class="highlight">
124
- <pre> <span class="c1">#---------------------------------------------------------------#</span>
125
- <span class="c1"># The default SSL endpoint is "https://api.thrillcall.com/api/".</span>
126
- <span class="c1"># The default API version is 3.</span>
127
- <span class="c1"># By default, Faraday access logging is turned off.</span>
128
- <span class="c1"># Override if necessary:</span>
129
- <span class="c1">#---------------------------------------------------------------#</span>
130
- <span class="n">tc</span> <span class="o">=</span> <span class="no">ThrillcallAPI</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
131
- <span class="no">MY_API_KEY</span><span class="p">,</span>
132
- <span class="ss">:base_url</span> <span class="o">=&gt;</span> <span class="s2">"https://api.thrillcall.com/custom/"</span><span class="p">,</span>
133
- <span class="ss">:version</span> <span class="o">=&gt;</span> <span class="mi">3</span><span class="p">,</span>
134
- <span class="ss">:logger</span> <span class="o">=&gt;</span> <span class="kp">true</span>
135
- <span class="p">)</span>
136
- </pre>
137
- </div>
138
-
139
-
140
- <p>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.</p>
141
-
142
- <div class="highlight">
143
- <pre> <span class="c1">#---------------------------------------------------------------#</span>
144
- <span class="c1"># Build a partial request, add on to it later</span>
145
- <span class="c1">#---------------------------------------------------------------#</span>
146
- <span class="n">request</span> <span class="o">=</span> <span class="n">tc</span><span class="o">.</span><span class="n">artist</span><span class="p">(</span><span class="mi">22210</span><span class="p">)</span> <span class="c1"># Lady Gaga</span>
147
-
148
- <span class="c1"># GET "/artist/22210/events?limit=2"</span>
149
- <span class="n">artist_events</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">events</span><span class="p">(</span><span class="ss">:limit</span> <span class="o">=&gt;</span> <span class="mi">2</span><span class="p">)</span>
150
-
151
- <span class="n">artist_events</span><span class="o">.</span><span class="n">length</span>
152
- <span class="c1"># =&gt; 2</span>
153
- </pre>
154
- </div>
155
-
156
-
157
- <p>This gem is a convenience wrapper around the excellent Faraday project. If more complicated use cases are necessary, consider using Faraday directly.</p>
158
-
159
- <div class="highlight">
160
- <pre> <span class="nb">require</span> <span class="s1">'faraday'</span>
161
- <span class="nb">require</span> <span class="s1">'json'</span>
162
-
163
- <span class="no">MY_API_KEY</span> <span class="o">=</span> <span class="s2">"1234567890abcdef"</span>
164
- <span class="no">BASE_URL</span> <span class="o">=</span> <span class="s2">"https://api.thrillcall.com/api/v3/"</span>
165
- <span class="no">HEADERS</span> <span class="o">=</span> <span class="p">{</span> <span class="ss">:accept</span> <span class="o">=&gt;</span> <span class="s1">'application/json'</span> <span class="p">}</span>
166
-
167
- <span class="n">connection</span> <span class="o">=</span> <span class="no">Faraday</span><span class="o">.</span><span class="n">new</span><span class="p">(</span> <span class="ss">:url</span> <span class="o">=&gt;</span> <span class="no">BASE_URL</span><span class="p">,</span> <span class="ss">:headers</span> <span class="o">=&gt;</span> <span class="no">HEADERS</span> <span class="p">)</span> <span class="k">do</span> <span class="o">|</span><span class="n">builder</span><span class="o">|</span>
168
- <span class="n">builder</span><span class="o">.</span><span class="n">adapter</span> <span class="no">Faraday</span><span class="o">.</span><span class="n">default_adapter</span>
169
- <span class="n">builder</span><span class="o">.</span><span class="n">response</span> <span class="ss">:logger</span>
170
- <span class="n">builder</span><span class="o">.</span><span class="n">response</span> <span class="ss">:raise_error</span>
171
- <span class="k">end</span>
172
-
173
- <span class="n">request</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="n">get</span> <span class="k">do</span> <span class="o">|</span><span class="n">req</span><span class="o">|</span>
174
- <span class="n">req</span><span class="o">.</span><span class="n">url</span> <span class="s2">"artist/22210"</span><span class="p">,</span> <span class="p">{</span> <span class="ss">:api_key</span> <span class="o">=&gt;</span> <span class="no">MY_API_KEY</span> <span class="p">}</span>
175
- <span class="k">end</span>
176
-
177
- <span class="n">artist</span> <span class="o">=</span> <span class="no">JSON</span><span class="o">.</span><span class="n">parse</span><span class="p">(</span><span class="n">request</span><span class="o">.</span><span class="n">body</span><span class="p">)</span>
178
-
179
- <span class="n">artist</span><span class="o">[</span><span class="s2">"name"</span><span class="o">]</span>
180
- <span class="c1"># =&gt; "Lady Gaga"</span>
181
- </pre>
182
- </div>
183
-
184
-
185
- <h1>HTTPS Endpoints</h1>
186
-
187
- <h3>SSL/TLS Endpoints Required:</h3>
188
-
189
- <p>All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443
190
- Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.</p>
191
-
192
- <h3>Parameters</h3>
193
-
194
- <p>These are valid parameters for any endpoint, however, they will only be used by the server where applicable.</p>
195
-
196
- <p><strong>api_key</strong> MUST BE SUPPLIED for every endpoint.</p>
197
-
198
- <ul>
199
- <li>
200
- <p><a name="api_key"></a><strong>api_key</strong> <em>string: (format: length == 16)</em></p>
201
-
202
- <p>Your API key. Required for access to any endpoint.</p>
203
- </li>
204
- <li>
205
- <p><a name="limit"></a><strong>limit</strong> <em>integer</em></p>
206
-
207
- <p><em>Default: 100</em></p>
208
-
209
- <p>Sets the maximum number of results to return. Cannot be above 200.</p>
210
- </li>
211
- <li>
212
- <p><a name="page"></a><strong>page</strong> <em>integer</em></p>
213
-
214
- <p><em>Default: 0</em></p>
215
-
216
- <p>Used in conjunction with <strong><a href="#limit">limit</a></strong>.</p>
217
-
218
- <p>Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29</p>
219
- </li>
220
- <li>
221
- <p><a name="time_zone"></a><strong>time_zone</strong> <em>string (format: TZ Database string, eg "America/Los</em>Angeles")_</p>
222
-
223
- <p><em>Default: UTC</em>
224
- <em>For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden.</em></p>
225
-
226
- <p><strong><a href="#min_date">min_date</a></strong> and <strong><a href="#max_date">max_date</a></strong> will be calculated based on this time zone.</p>
227
- </li>
228
- <li>
229
- <p><a name="min_date"></a><strong>min_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
230
-
231
- <p><em>Default: Today</em></p>
232
-
233
- <p>Results before this date will not be returned.</p>
234
- </li>
235
- <li>
236
- <p><a name="max_date"></a><strong>max_date</strong> <em>string (format: "YYYY-MM-DD")</em></p>
237
-
238
- <p><em>Default: 1 year from Today</em></p>
239
-
240
- <p>Results after this date will not be returned.</p>
241
- </li>
242
- <li>
243
- <p><a name="min_updated_at"></a><strong>min_updated_at</strong> <em>string (format: "YYYY-MM-DD")</em></p>
244
-
245
- <p><em>Default: none</em></p>
246
-
247
- <p>Results with updated_at columns before this date will not be returned.</p>
248
- </li>
249
- <li>
250
- <p><a name="max_date"></a><strong>max_updated_at</strong> <em>string (format: "YYYY-MM-DD")</em></p>
251
-
252
- <p><em>Default: none</em></p>
253
-
254
- <p>Results with updated_at columns after this date will not be returned.</p>
255
- </li>
256
- <li>
257
- <p><a name="lat"></a><strong>lat</strong> <em>float</em></p>
258
-
259
- <p><em>Default: none</em></p>
260
-
261
- <p>If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, results will be within <strong><a href="#radius">radius</a></strong> of this location.</p>
262
-
263
- <p>For Person queries, this specifies the latitude of the person's location.</p>
264
- </li>
265
- <li>
266
- <p><a name="long"></a><strong>long</strong> <em>float</em></p>
267
-
268
- <p><em>Default: none</em></p>
269
-
270
- <p>If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, results will be within <strong><a href="#radius">radius</a></strong> of this location.</p>
271
-
272
- <p>For Person queries, this specifies the longitude of the person's location.</p>
273
- </li>
274
- <li>
275
- <p><a name="postalcode"></a><strong>postalcode</strong> <em>string (format: length &gt;= 5)</em></p>
276
-
277
- <p><em>Default: none</em></p>
278
-
279
- <p>Results will be within the <strong><a href="#radius">radius</a></strong> of this postal code.
280
- If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a href="#long">long</a></strong>) if both are specified, this will be ignored.</p>
281
- </li>
282
- <li>
283
- <p><a name="radius"></a><strong>radius</strong> <em>float</em></p>
284
-
285
- <p><em>Default: 100.0</em></p>
286
-
287
- <p>Used in conjunction with <strong><a href="#postalcode">postalcode</a></strong></p>
288
- </li>
289
- <li>
290
- <p><a name="use_partner_id"></a><strong>use_partner_id</strong> <em>boolean</em></p>
291
-
292
- <p><em>Default: false</em></p>
293
-
294
- <p>If set to <em>true</em> or <em>1</em>, instead of using Thrillcall internal IDs, treat any IDs in a request as belonging to your partner definition.</p>
295
-
296
- <p>Contact us to set up a list of definitions.</p>
297
- </li>
298
- <li>
299
- <p><a name="ticket_type"></a><strong>ticket_type</strong> <em>string (format: "primary" or "resale")</em></p>
300
-
301
- <p><em>Default: both</em></p>
302
-
303
- <p>If specified, will only return tickets from Primary or Resale merchants.</p>
304
- </li>
305
- <li>
306
- <p><a name="must_have_tickets"></a><strong>must_have_tickets</strong> <em>boolean</em></p>
307
-
308
- <p><em>Default: false</em></p>
309
-
310
- <p>If set to <em>true</em> or <em>1</em>, will only return results that have tickets associated with them.</p>
311
- </li>
312
- <li>
313
- <p><a name="show_disabled_events"></a><strong>show_disabled_events</strong> <em>boolean</em></p>
314
-
315
- <p><em>Default: false</em></p>
316
-
317
- <p>If set to <em>true</em> or <em>1</em>, will not filter out events which have been disabled internally.</p>
318
- </li>
319
- <li>
320
- <p><a name="show_unconfirmed_events"></a><strong>show_unconfirmed_events</strong> <em>boolean</em></p>
321
-
322
- <p><em>Default: false</em></p>
323
-
324
- <p>If set to <em>true</em> or <em>1</em>, will not filter out events with unconfirmed locations.</p>
325
- </li>
326
- <li>
327
- <p><a name="show_rumor_events"></a><strong>show_rumor_events</strong> <em>boolean</em></p>
328
-
329
- <p><em>Default: false</em></p>
330
-
331
- <p>If set to <em>true</em> or <em>1</em>, will not filter out events marked as rumored.</p>
332
- </li>
333
- <li>
334
- <p><a name="primary_genre_id"></a><strong>primary_genre_id</strong> <em>integer</em></p>
335
-
336
- <p><em>Default: none</em></p>
337
-
338
- <p>If set, will filter Artist results to only those with the specified <strong><a href="#primary_genre_id">primary_genre_id</a></strong></p>
339
- </li>
340
- <li>
341
- <p><a name="email"></a><strong>email</strong> <em>string</em></p>
342
-
343
- <p>The email address associated with a user, required for registration.</p>
344
- </li>
345
- <li>
346
- <p><a name="password"></a><strong>password</strong> <em>string (format: 40 &gt;= length &gt;= 5)</em></p>
347
-
348
- <p>The user's password. Must be supplied along with <strong><a href="#email">email</a></strong> unless using <strong><a href="#provider">provider</a></strong> / <strong><a href="#uid">uid</a></strong> / <strong><a href="#token">token</a></strong> auth.</p>
349
- </li>
350
- <li>
351
- <p><a name="provider"></a><strong>provider</strong> <em>string</em></p>
352
-
353
- <p>The name of the authentication provider (e.g. "facebook"). Must be supplied along with <strong><a href="#uid">uid</a></strong> and <strong><a href="#token">token</a></strong> unless using <strong><a href="#email">email</a></strong>/<strong><a href="#password">password</a></strong> auth.</p>
354
- </li>
355
- <li>
356
- <p><a name="uid"></a><strong>uid</strong> <em>string</em></p>
357
-
358
- <p>The user's ID with <strong><a href="#provider">provider</a></strong>. Must be supplied along with <strong><a href="#provider">provider</a></strong> and <strong><a href="#token">token</a></strong> unless using <strong><a href="#email">email</a></strong>/<strong><a href="#password">password</a></strong> auth.</p>
359
- </li>
360
- <li>
361
- <p><a name="token"></a><strong>token</strong> <em>string</em></p>
362
-
363
- <p>The user's authentication token with <strong><a href="#provider">provider</a></strong>. Must be supplied along with <strong><a href="#provider">provider</a></strong> and <strong><a href="#uid">uid</a></strong> unless using <strong><a href="#email">email</a></strong>/<strong><a href="#password">password</a></strong> auth.</p>
364
- </li>
365
- <li>
366
- <p><a name="first_name"></a><strong>first_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
367
-
368
- <p>Required to register a user.</p>
369
- </li>
370
- <li>
371
- <p><a name="last_name"></a><strong>last_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
372
-
373
- <p>Optional for registering a user.</p>
374
- </li>
375
- <li>
376
- <p><a name="gender"></a><strong>gender</strong> <em>string (format: length == 1)</em></p>
377
-
378
- <p>Optional for registering a user.</p>
379
- </li>
380
- <li>
381
- <p><a name="location_name"></a><strong>location_name</strong> <em>string (format: "City, ST or City, State", length &gt; 0))</em></p>
382
-
383
- <p>The name of the user's location when auto-registering. Either this or <strong><a href="#lat">lat</a></strong> / <strong><a href="#long">long</a></strong> must be provided.</p>
384
- </li>
385
- <li>
386
- <p><a name="referral_code"></a><strong>referral_code</strong> <em>string</em></p>
387
-
388
- <p>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.</p>
389
- </li>
390
- </ul><h2>Artists</h2>
391
-
392
- <p>Fields:</p>
393
-
394
- <ul>
395
- <li>
396
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
397
- <li>
398
- <strong>genre_tags</strong> <em>string</em> Semicolon separated list of Genre names</li>
399
- <li>
400
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
401
- <li>
402
- <strong>name</strong> <em>string</em> Artist / Band Name</li>
403
- <li>
404
- <strong>primary_genre_id</strong> <em>integer</em> The Thrillcall ID for this artist's primary Genre</li>
405
- <li>
406
- <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
407
- <li>
408
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
409
- <li>
410
- <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
411
- <li>
412
- <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
413
- </ul><h3>GET /artists</h3>
414
-
415
- <p>Params:</p>
416
-
417
- <ul>
418
- <li><strong><a href="#limit">limit</a></strong></li>
419
- <li><strong><a href="#page">page</a></strong></li>
420
- <li><strong><a href="#primary_genre_id">primary_genre_id</a></strong></li>
421
- </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
422
-
423
- <div class="highlight">
424
- <pre> <span class="c1">// Example: GET /api/v3/artists?limit=14&amp;api_key=1234567890abcdef</span>
425
-
426
- <span class="p">[</span>
427
- <span class="p">{</span>
428
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:19:45Z"</span><span class="p">,</span>
429
- <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"O"</span><span class="p">,</span>
430
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
431
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Hyler Jones Proteges"</span><span class="p">,</span>
432
- <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
433
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
434
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
435
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
436
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
437
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
438
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
439
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-mobile.jpg"</span>
440
- <span class="p">},</span>
441
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
442
- <span class="p">},</span>
443
- <span class="p">{</span>
444
- <span class="p">...</span>
445
- <span class="p">},</span>
446
- <span class="p">...</span>
447
- <span class="p">]</span>
448
- </pre>
449
- </div>
450
-
451
-
452
- <h3>GET /artist/:id</h3>
453
-
454
- <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
455
-
456
- <p>Params:</p>
457
-
458
- <ul>
459
- <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
460
- </ul><p>Returns: Artist <em>Hash</em></p>
461
-
462
- <div class="highlight">
463
- <pre> <span class="c1">// Example: GET /api/v3/artist/378465?api_key=1234567890abcdef</span>
464
-
465
- <span class="p">{</span>
466
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
467
- <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
468
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
469
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
470
- <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
471
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
472
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
473
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
474
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
475
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
476
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
477
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
478
- <span class="p">},</span>
479
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
480
- <span class="p">}</span>
481
- </pre>
482
- </div>
483
-
484
-
485
- <h3>GET /artist/:id/events</h3>
486
-
487
- <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
488
-
489
- <p>Params:</p>
490
-
491
- <ul>
492
- <li><strong><a href="#limit">limit</a></strong></li>
493
- <li><strong><a href="#page">page</a></strong></li>
494
- <li><strong><a href="#time_zone">time_zone</a></strong></li>
495
- <li><strong><a href="#min_date">min_date</a></strong></li>
496
- <li><strong><a href="#max_date">max_date</a></strong></li>
497
- <li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
498
- <li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
499
- <li><strong><a href="#lat">lat</a></strong></li>
500
- <li><strong><a href="#long">long</a></strong></li>
501
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
502
- <li><strong><a href="#radius">radius</a></strong></li>
503
- <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
504
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
505
- <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
506
- <li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
507
- <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
508
- <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
509
- </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
510
-
511
- <div class="highlight">
512
- <pre> <span class="c1">// Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef</span>
513
-
514
- <span class="p">[</span>
515
- <span class="p">{</span>
516
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T08:01:03Z"</span><span class="p">,</span>
517
- <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
518
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1046915</span><span class="p">,</span>
519
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">47.6136</span><span class="p">,</span>
520
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.332</span><span class="p">,</span>
521
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Paramount Theatre - Seattle"</span><span class="p">,</span>
522
- <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
523
- <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
524
- <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-10-02T19:30:00Z"</span><span class="p">,</span>
525
- <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-10-03T02:30:00Z"</span><span class="p">,</span>
526
- <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
527
- <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
528
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:53Z"</span><span class="p">,</span>
529
- <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">61705</span><span class="p">,</span>
530
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
531
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
532
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
533
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
534
- <span class="p">},</span>
535
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1046915"</span><span class="p">,</span>
536
- <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-10-02T19:30:00-07:00"</span><span class="p">,</span>
537
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
538
- <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
539
- <span class="p">},</span>
540
- <span class="p">{</span>
541
- <span class="p">...</span>
542
- <span class="p">},</span>
543
- <span class="p">...</span>
544
- <span class="p">]</span>
545
- </pre>
546
- </div>
547
-
548
-
549
- <h3>GET /search/artists/:term</h3>
550
-
551
- <p><strong>:term</strong> <em>string</em> Arbitrary search string on the <strong>name</strong> field. (alphanumerics only, underscore matches underscore, use '+' for space)</p>
552
-
553
- <p>Params:</p>
554
-
555
- <ul>
556
- <li><strong><a href="#limit">limit</a></strong></li>
557
- <li><strong><a href="#page">page</a></strong></li>
558
- </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
559
-
560
- <div class="highlight">
561
- <pre> <span class="c1">// Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef</span>
562
-
563
- <span class="p">[</span>
564
- <span class="p">{</span>
565
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
566
- <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
567
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
568
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
569
- <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
570
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
571
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
572
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
573
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
574
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
575
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
576
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
577
- <span class="p">},</span>
578
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
579
- <span class="p">},</span>
580
- <span class="p">{</span>
581
- <span class="p">...</span>
582
- <span class="p">},</span>
583
- <span class="p">...</span>
584
- <span class="p">]</span>
585
- </pre>
586
- </div>
587
-
588
-
589
- <h2>Events</h2>
590
-
591
- <p>Fields:</p>
592
-
593
- <ul>
594
- <li>
595
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
596
- <li>
597
- <strong>festival</strong> <em>boolean</em> Is this event a festival?</li>
598
- <li>
599
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
600
- <li>
601
- <strong>latitude</strong> <em>float</em> Approximate latitude for the Event</li>
602
- <li>
603
- <strong>longitude</strong> <em>float</em> Approximate longitude for the Event</li>
604
- <li>
605
- <strong>name</strong> <em>string</em> Name of the Event</li>
606
- <li>
607
- <strong>on_sale_date</strong> <em>string</em> ISO 8601 representation of the date when tickets go on sale</li>
608
- <li>
609
- <strong>rumor</strong> <em>boolean</em> Are the details for this event based on a rumor?</li>
610
- <li>
611
- <strong>status</strong> <em>string</em> Status of the event (confirmed, unconfirmed, cancelled, or disabled)</li>
612
- <li>
613
- <strong>starts_at</strong> <em>string</em> ISO 8601 representation of the start of the Event in UTC time</li>
614
- <li>
615
- <strong>starts_at_local</strong> <em>string</em> ISO 8601 representation of the start of the Event in the local timezone</li>
616
- <li>
617
- <strong>starts_at_time_trusted</strong> <em>boolean</em> Do we trust that the time of day component of <strong>starts_at</strong> is valid?</li>
618
- <li>
619
- <strong>time_zone</strong> <em>string</em> TZ Database string representing the time zone at the location of the event</li>
620
- <li>
621
- <strong>unconfirmed_location</strong> <em>integer</em> If 1, the location of this event is unconfirmed</li>
622
- <li>
623
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
624
- <li>
625
- <strong>venue_id</strong> <em>integer</em> Thrillcall Venue ID</li>
626
- <li>
627
- <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
628
- <li>
629
- <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
630
- </ul><h3>GET /events</h3>
631
-
632
- <p>Params:</p>
633
-
634
- <ul>
635
- <li><strong><a href="#limit">limit</a></strong></li>
636
- <li><strong><a href="#page">page</a></strong></li>
637
- <li><strong><a href="#time_zone">time_zone</a></strong></li>
638
- <li><strong><a href="#min_date">min_date</a></strong></li>
639
- <li><strong><a href="#max_date">max_date</a></strong></li>
640
- <li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
641
- <li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
642
- <li><strong><a href="#lat">lat</a></strong></li>
643
- <li><strong><a href="#long">long</a></strong></li>
644
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
645
- <li><strong><a href="#radius">radius</a></strong></li>
646
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
647
- <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
648
- <li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
649
- <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
650
- <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
651
- </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
652
-
653
- <div class="highlight">
654
- <pre> <span class="c1">// Example: GET /api/v3/events?must_have_tickets=true&amp;postalcode=94108&amp;radius=10&amp;limit=3&amp;api_key=1234567890abcdef</span>
655
-
656
- <span class="p">[</span>
657
- <span class="p">{</span>
658
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
659
- <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
660
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
661
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7915</span><span class="p">,</span>
662
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.413</span><span class="p">,</span>
663
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Masonic Center"</span><span class="p">,</span>
664
- <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
665
- <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
666
- <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04Z"</span><span class="p">,</span>
667
- <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-09-30T02:30:04Z"</span><span class="p">,</span>
668
- <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
669
- <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
670
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:57Z"</span><span class="p">,</span>
671
- <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
672
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
673
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
674
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
675
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
676
- <span class="p">},</span>
677
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1047075"</span><span class="p">,</span>
678
- <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04-07:00"</span><span class="p">,</span>
679
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
680
- <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
681
- <span class="p">},</span>
682
- <span class="p">{</span>
683
- <span class="p">...</span>
684
- <span class="p">},</span>
685
- <span class="p">...</span>
686
- <span class="p">]</span>
687
- </pre>
688
- </div>
689
-
690
-
691
- <h3>GET /event/:id</h3>
692
-
693
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
694
-
695
- <p>Params:</p>
696
-
697
- <ul>
698
- <li>None</li>
699
- </ul><p>Returns: Event <em>Hash</em></p>
700
-
701
- <div class="highlight">
702
- <pre> <span class="c1">// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef</span>
703
-
704
- <span class="p">{</span>
705
- <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"1111 California Street"</span><span class="p">,</span>
706
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
707
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
708
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
709
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2009-08-25T19:25:27Z"</span><span class="p">,</span>
710
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
711
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.79153</span><span class="p">,</span>
712
- <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
713
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.412757</span><span class="p">,</span>
714
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Masonic Center"</span><span class="p">,</span>
715
- <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
716
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
717
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
718
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">4</span><span class="p">,</span>
719
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-04-04T02:08:50Z"</span><span class="p">,</span>
720
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94108"</span><span class="p">,</span>
721
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
722
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135"</span><span class="p">,</span>
723
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135"</span><span class="p">,</span>
724
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135"</span><span class="p">,</span>
725
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"</span>
726
- <span class="p">},</span>
727
- <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
728
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"</span>
729
- <span class="p">}</span>
730
- </pre>
731
- </div>
732
-
733
-
734
- <h3>GET /event/:id/artists</h3>
735
-
736
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
737
-
738
- <p>Params:</p>
739
-
740
- <ul>
741
- <li><strong><a href="#limit">limit</a></strong></li>
742
- <li><strong><a href="#page">page</a></strong></li>
743
- </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
744
-
745
- <div class="highlight">
746
- <pre> <span class="c1">// Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef</span>
747
-
748
- <span class="p">[</span>
749
- <span class="p">{</span>
750
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-05-19T20:27:47Z"</span><span class="p">,</span>
751
- <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"Operatic pop"</span><span class="p">,</span>
752
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">378465</span><span class="p">,</span>
753
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo"</span><span class="p">,</span>
754
- <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
755
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">30</span><span class="p">,</span>
756
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-27T15:59:04Z"</span><span class="p">,</span>
757
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
758
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
759
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426"</span><span class="p">,</span>
760
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
761
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
762
- <span class="p">},</span>
763
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Il_Volo"</span>
764
- <span class="p">},</span>
765
- <span class="p">{</span>
766
- <span class="p">...</span>
767
- <span class="p">},</span>
768
- <span class="p">...</span>
769
- <span class="p">]</span>
770
- </pre>
771
- </div>
772
-
773
-
774
- <h3>GET /event/:id/venue</h3>
775
-
776
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
777
-
778
- <p>Params:</p>
779
-
780
- <ul>
781
- <li>None</li>
782
- </ul><p>Returns: Venue <em>Hash</em></p>
783
-
784
- <div class="highlight">
785
- <pre> <span class="c1">// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef</span>
786
-
787
- <span class="p">{</span>
788
- <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"1111 California Street"</span><span class="p">,</span>
789
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
790
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
791
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
792
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2009-08-25T19:25:27Z"</span><span class="p">,</span>
793
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
794
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.79153</span><span class="p">,</span>
795
- <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
796
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.412757</span><span class="p">,</span>
797
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Masonic Center"</span><span class="p">,</span>
798
- <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
799
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
800
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
801
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">4</span><span class="p">,</span>
802
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-04-04T02:08:50Z"</span><span class="p">,</span>
803
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94108"</span><span class="p">,</span>
804
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
805
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135"</span><span class="p">,</span>
806
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135"</span><span class="p">,</span>
807
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135"</span><span class="p">,</span>
808
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"</span>
809
- <span class="p">},</span>
810
- <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
811
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"</span>
812
- <span class="p">}</span>
813
- </pre>
814
- </div>
815
-
816
-
817
- <h3>GET /event/:id/tickets</h3>
818
-
819
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
820
-
821
- <p>Params:</p>
822
-
823
- <ul>
824
- <li><strong><a href="#limit">limit</a></strong></li>
825
- <li><strong><a href="#page">page</a></strong></li>
826
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
827
- </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
828
-
829
- <div class="highlight">
830
- <pre> <span class="c1">// Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef</span>
831
-
832
- <span class="p">[</span>
833
- <span class="p">{</span>
834
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
835
- <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
836
- <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
837
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">819883</span><span class="p">,</span>
838
- <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
839
- <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">85</span><span class="p">,</span>
840
- <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="mi">29</span><span class="p">,</span>
841
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Onsale to General Public"</span><span class="p">,</span>
842
- <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
843
- <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
844
- <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
845
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
846
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://ticketsus.at/thrillcall?CTY=39&amp;DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&amp;brand=[=BRAND=]"</span>
847
- <span class="p">},</span>
848
- <span class="p">{</span>
849
- <span class="p">...</span>
850
- <span class="p">},</span>
851
- <span class="p">...</span>
852
- <span class="p">]</span>
853
- </pre>
854
- </div>
855
-
856
-
857
- <h2>Genre</h2>
858
-
859
- <p>Fields:</p>
860
-
861
- <ul>
862
- <li>
863
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
864
- <li>
865
- <strong>description</strong> <em>string</em> Description of the Genre</li>
866
- <li>
867
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
868
- <li>
869
- <strong>name</strong> <em>string</em> Name of the Genre</li>
870
- <li>
871
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
872
- </ul><h3>GET /genres</h3>
873
-
874
- <p>Params:</p>
875
-
876
- <ul>
877
- <li><strong><a href="#limit">limit</a></strong></li>
878
- <li><strong><a href="#page">page</a></strong></li>
879
- </ul><p>Returns: <em>Array</em> of Genres <em>Hash</em></p>
880
-
881
- <div class="highlight">
882
- <pre> <span class="c1">// Example: GET /api/v3/genres?limit=14&amp;api_key=1234567890abcdef</span>
883
-
884
- <span class="p">[</span>
885
- <span class="p">{</span>
886
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
887
- <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"Shawn Colvin, Loudon Wainwright III etc..."</span><span class="p">,</span>
888
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">6</span><span class="p">,</span>
889
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Folk"</span><span class="p">,</span>
890
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:51:55Z"</span>
891
- <span class="p">},</span>
892
- <span class="p">{</span>
893
- <span class="p">...</span>
894
- <span class="p">},</span>
895
- <span class="p">...</span>
896
- <span class="p">]</span>
897
- </pre>
898
- </div>
899
-
900
-
901
- <h3>GET /genre/:id</h3>
902
-
903
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
904
-
905
- <p>Params:</p>
906
-
907
- <ul>
908
- <li>None</li>
909
- </ul><p>Returns: Genre <em>Hash</em></p>
910
-
911
- <div class="highlight">
912
- <pre> <span class="c1">// Example: GET /api/v3/genre/27?api_key=1234567890abcdef</span>
913
-
914
- <span class="p">{</span>
915
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-07-09T19:17:45Z"</span><span class="p">,</span>
916
- <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"U2, 30 Seconds To Mars etc..."</span><span class="p">,</span>
917
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
918
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Rock"</span><span class="p">,</span>
919
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-25T23:52:21Z"</span>
920
- <span class="p">}</span>
921
- </pre>
922
- </div>
923
-
924
-
925
- <h3>GET /genre/:id/artists</h3>
926
-
927
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
928
-
929
- <p>Params:</p>
930
-
931
- <ul>
932
- <li><strong><a href="#limit">limit</a></strong></li>
933
- <li><strong><a href="#page">page</a></strong></li>
934
- </ul><p>Returns: <em>Array</em> of Artists <em>Hash</em></p>
935
-
936
- <div class="highlight">
937
- <pre> <span class="c1">// Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef</span>
938
-
939
- <span class="p">[</span>
940
- <span class="p">{</span>
941
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-29T10:19:45Z"</span><span class="p">,</span>
942
- <span class="s2">"genre_tags"</span><span class="o">:</span> <span class="s2">"O"</span><span class="p">,</span>
943
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
944
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Hyler Jones Proteges"</span><span class="p">,</span>
945
- <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
946
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
947
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
948
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
949
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
950
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
951
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
952
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/artist/_default/default-mobile.jpg"</span>
953
- <span class="p">},</span>
954
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
955
- <span class="p">},</span>
956
- <span class="p">{</span>
957
- <span class="p">...</span>
958
- <span class="p">},</span>
959
- <span class="p">...</span>
960
- <span class="p">]</span>
961
- </pre>
962
- </div>
963
-
964
-
965
- <h2>Metro Area</h2>
966
-
967
- <p>Fields:</p>
968
-
969
- <ul>
970
- <li>
971
- <strong>city</strong> <em>string</em> City of the Metro Area</li>
972
- <li>
973
- <strong>country</strong> <em>string</em> Country of the Metro Area</li>
974
- <li>
975
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
976
- <li>
977
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
978
- <li>
979
- <strong>latitude</strong> <em>float</em> Latitude of the Metro Area</li>
980
- <li>
981
- <strong>longitude</strong> <em>float</em> Longitude of the Metro Area</li>
982
- <li>
983
- <strong>radius</strong> <em>integer</em> Radius of the Metro Area from the Lat/Long center</li>
984
- <li>
985
- <strong>state</strong> <em>string</em> State of the Metro Area</li>
986
- <li>
987
- <strong>time_zone</strong> <em>string</em> Time zone of the Metro Area</li>
988
- <li>
989
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
990
- <li>
991
- <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
992
- <li>
993
- <strong>offers_availability_status_code</strong> <em>integer</em> Offers status for the Metro Area ( no_offers = 0, available = 1, coming_soon = 2)</li>
994
- </ul><h3>GET /metro_areas</h3>
995
-
996
- <p>Params:</p>
997
-
998
- <ul>
999
- <li><strong><a href="#limit">limit</a></strong></li>
1000
- <li><strong><a href="#page">page</a></strong></li>
1001
- </ul><p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
1002
-
1003
- <div class="highlight">
1004
- <pre> <span class="c1">// Example: GET /api/v3/metro_areas?limit=14&amp;api_key=1234567890abcdef</span>
1005
-
1006
- <span class="p">[</span>
1007
- <span class="p">{</span>
1008
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Chicago"</span><span class="p">,</span>
1009
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1010
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
1011
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">104</span><span class="p">,</span>
1012
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">41.8842</span><span class="p">,</span>
1013
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">87.6324</span><span class="p">,</span>
1014
- <span class="s2">"offers_availability_status_code"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1015
- <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
1016
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"IL"</span><span class="p">,</span>
1017
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Chicago"</span><span class="p">,</span>
1018
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-12-27T00:44:37Z"</span><span class="p">,</span>
1019
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/chicago"</span>
1020
- <span class="p">},</span>
1021
- <span class="p">{</span>
1022
- <span class="p">...</span>
1023
- <span class="p">},</span>
1024
- <span class="p">...</span>
1025
- <span class="p">]</span>
1026
- </pre>
1027
- </div>
1028
-
1029
-
1030
- <h3>GET /metro_area/:id</h3>
1031
-
1032
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
1033
-
1034
- <p>Params:</p>
1035
-
1036
- <ul>
1037
- <li>None</li>
1038
- </ul><p>Returns: Metro Area <em>Hash</em></p>
1039
-
1040
- <div class="highlight">
1041
- <pre> <span class="c1">// Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef</span>
1042
-
1043
- <span class="p">{</span>
1044
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1045
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1046
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T03:23:57Z"</span><span class="p">,</span>
1047
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1048
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
1049
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
1050
- <span class="s2">"offers_availability_status_code"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1051
- <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
1052
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1053
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
1054
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-12-27T00:44:37Z"</span><span class="p">,</span>
1055
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/san-francisco"</span>
1056
- <span class="p">}</span>
1057
- </pre>
1058
- </div>
1059
-
1060
-
1061
- <h3>GET /metro_area/:id/events</h3>
1062
-
1063
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
1064
-
1065
- <p>Params:</p>
1066
-
1067
- <ul>
1068
- <li><strong><a href="#limit">limit</a></strong></li>
1069
- <li><strong><a href="#page">page</a></strong></li>
1070
- <li><strong><a href="#min_date">min_date</a></strong></li>
1071
- <li><strong><a href="#max_date">max_date</a></strong></li>
1072
- <li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
1073
- <li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
1074
- <li><strong><a href="#radius">radius</a></strong></li>
1075
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1076
- <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
1077
- <li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
1078
- <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1079
- <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1080
- </ul><p>Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.</p>
1081
-
1082
- <p>Returns: <em>Array</em> of Metro Areas <em>Hash</em></p>
1083
-
1084
- <div class="highlight">
1085
- <pre> <span class="c1">// Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&amp;max_date=2012-04-04&amp;limit=3&amp;api_key=1234567890abcdef</span>
1086
-
1087
- <span class="p">[</span>
1088
- <span class="p">{</span>
1089
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-01-02T08:53:00Z"</span><span class="p">,</span>
1090
- <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1091
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1011386</span><span class="p">,</span>
1092
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7771</span><span class="p">,</span>
1093
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
1094
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Kontrol @ The End Up"</span><span class="p">,</span>
1095
- <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1096
- <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1097
- <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-01-07T00:00:04Z"</span><span class="p">,</span>
1098
- <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-01-07T08:00:04Z"</span><span class="p">,</span>
1099
- <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1100
- <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1101
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:19:31Z"</span><span class="p">,</span>
1102
- <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">47273</span><span class="p">,</span>
1103
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1104
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1105
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
1106
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"</span>
1107
- <span class="p">},</span>
1108
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1011386"</span><span class="p">,</span>
1109
- <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-01-07T00:00:04-08:00"</span><span class="p">,</span>
1110
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
1111
- <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
1112
- <span class="p">},</span>
1113
- <span class="p">{</span>
1114
- <span class="p">...</span>
1115
- <span class="p">},</span>
1116
- <span class="p">...</span>
1117
- <span class="p">]</span>
1118
- </pre>
1119
- </div>
1120
-
1121
-
1122
- <h2>Person</h2>
1123
-
1124
- <p><strong>Note:</strong> Your API key requires the api_auth permission to access the endpoints associated with this object.</p>
1125
-
1126
- <p>Fields:</p>
1127
-
1128
- <ul>
1129
- <li>
1130
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1131
- <li>
1132
- <strong>first_name</strong> <em>string</em> First name of the Person</li>
1133
- <li>
1134
- <strong>gender</strong> <em>string</em> Gender of the Person</li>
1135
- <li>
1136
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1137
- <li>
1138
- <strong>last_name</strong> <em>string</em> Last name of the Person</li>
1139
- <li>
1140
- <strong>login</strong> <em>string</em> Login (Email Address) of the Person</li>
1141
- <li>
1142
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1143
- <li>
1144
- <strong>referral_code</strong> <em>string</em> Referral code of the Person</li>
1145
- <li>
1146
- <strong>referral_credits</strong> <em>integer</em> Number of Referral credits the Person has (including bonus points)</li>
1147
- <li>
1148
- <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
1149
- <li>
1150
- <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
1151
- </ul><h3>GET /person/:id</h3>
1152
-
1153
- <p>Params:</p>
1154
-
1155
- <ul>
1156
- <li>None.</li>
1157
- </ul><p>Returns: Person <em>Hash</em></p>
1158
-
1159
- <div class="highlight">
1160
- <pre> <span class="c1">// Example: GET /api/v3/person/49?api_key=1234567890abcdef</span>
1161
-
1162
- <span class="p">{</span>
1163
- <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1164
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1165
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Santa Rosa"</span><span class="p">,</span>
1166
- <span class="s2">"country_code"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1167
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2011-10-17T18:54:31Z"</span><span class="p">,</span>
1168
- <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"John"</span><span class="p">,</span>
1169
- <span class="s2">"gender"</span><span class="o">:</span> <span class="s2">"m"</span><span class="p">,</span>
1170
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">49</span><span class="p">,</span>
1171
- <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Doe"</span><span class="p">,</span>
1172
- <span class="s2">"login"</span><span class="o">:</span> <span class="s2">"bogus@bogus.com"</span><span class="p">,</span>
1173
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1174
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
1175
- <span class="s2">"timezone"</span><span class="o">:</span> <span class="s2">"-7"</span><span class="p">,</span>
1176
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T16:07:16Z"</span><span class="p">,</span>
1177
- <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1178
- <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1179
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"95407"</span><span class="p">,</span>
1180
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1181
- <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419"</span><span class="p">,</span>
1182
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419"</span><span class="p">,</span>
1183
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"</span>
1184
- <span class="p">}</span>
1185
- <span class="p">}</span>
1186
- </pre>
1187
- </div>
1188
-
1189
-
1190
- <h3>POST /person/signin</h3>
1191
-
1192
- <p>Params:</p>
1193
-
1194
- <ul>
1195
- <li><strong><a href="#email">email</a></strong></li>
1196
- <li><strong><a href="#password">password</a></strong></li>
1197
- <li><strong><a href="#provider">provider</a></strong></li>
1198
- <li><strong><a href="#uid">uid</a></strong></li>
1199
- <li><strong><a href="#token">token</a></strong></li>
1200
- <li><strong><a href="#first_name">first_name</a></strong></li>
1201
- <li><strong><a href="#last_name">last_name</a></strong></li>
1202
- <li><strong><a href="#location_name">location_name</a></strong></li>
1203
- <li><strong><a href="#lat">lat</a></strong></li>
1204
- <li><strong><a href="#long">long</a></strong></li>
1205
- <li><strong><a href="#referral_code">referral_code</a></strong></li>
1206
- </ul><p>Use either <strong><a href="#email">email</a></strong> / <strong><a href="#password">password</a></strong> or <strong><a href="#provider">provider</a></strong> / <strong><a href="#uid">uid</a></strong> / <strong><a href="#token">token</a></strong>.</p>
1207
-
1208
- <p>May perform registration ("signup") automatically if using <strong><a href="#provider">provider</a></strong> / <strong><a href="#uid">uid</a></strong> / <strong><a href="#token">token</a></strong> when no match is found and name, location, and <strong><a href="#referral_code">referral_code</a></strong> are also provided.</p>
1209
-
1210
- <p>Returns: Person <em>Hash</em></p>
1211
-
1212
- <div class="highlight">
1213
- <pre> <span class="c1">// Example: POST /api/v3/person/signin?provider=facebook&amp;uid=123123bogus&amp;token=123123bogus&amp;email=123123bogus%40bogus.com&amp;first_name=Mister&amp;last_name=Bogus&amp;lat=38.5&amp;long=-123.0&amp;api_key=1234567890abcdef</span>
1214
-
1215
- <span class="p">{</span>
1216
- <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1217
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1218
- <span class="s2">"city"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1219
- <span class="s2">"country_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1220
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1221
- <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"Mister"</span><span class="p">,</span>
1222
- <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1223
- <span class="s2">"last_name"</span><span class="o">:</span> <span class="s2">"Bogus"</span><span class="p">,</span>
1224
- <span class="s2">"login"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1225
- <span class="s2">"state"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1226
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1227
- <span class="s2">"timezone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1228
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1229
- <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1230
- <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1231
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1232
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1233
- <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
1234
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1235
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-medium.jpg"</span>
1236
- <span class="p">}</span>
1237
- <span class="p">}</span>
1238
- </pre>
1239
- </div>
1240
-
1241
-
1242
- <h3>POST /person/signup</h3>
1243
-
1244
- <p>Params:</p>
1245
-
1246
- <ul>
1247
- <li><strong><a href="#first_name">first_name</a></strong></li>
1248
- <li><strong><a href="#last_name">last_name</a></strong></li>
1249
- <li><strong><a href="#gender">gender</a></strong></li>
1250
- <li><strong><a href="#email">email</a></strong></li>
1251
- <li><strong><a href="#password">password</a></strong></li>
1252
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
1253
- <li><strong><a href="#referral_code">referral_code</a></strong></li>
1254
- </ul><p>Returns: Person <em>Hash</em></p>
1255
-
1256
- <div class="highlight">
1257
- <pre> <span class="c1">// Example: POST /api/v3/person/signup?first_name=Mister&amp;email=bogus%40bogus.com&amp;password=bogus&amp;postalcode=94108&amp;api_key=1234567890abcdef</span>
1258
-
1259
- <span class="p">{</span>
1260
- <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1261
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1262
- <span class="s2">"city"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1263
- <span class="s2">"country_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1264
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1265
- <span class="s2">"first_name"</span><span class="o">:</span> <span class="s2">"Mister"</span><span class="p">,</span>
1266
- <span class="s2">"gender"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1267
- <span class="s2">"last_name"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1268
- <span class="s2">"login"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1269
- <span class="s2">"state"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1270
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1271
- <span class="s2">"timezone"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1272
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1273
- <span class="s2">"referral_code"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1274
- <span class="s2">"referral_credits"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1275
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1276
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1277
- <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
1278
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1279
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/person/_default/default-medium.jpg"</span>
1280
- <span class="p">}</span>
1281
- <span class="p">}</span>
1282
- </pre>
1283
- </div>
1284
-
1285
-
1286
- <h2>Venues</h2>
1287
-
1288
- <p>Fields:</p>
1289
-
1290
- <ul>
1291
- <li>
1292
- <strong>address1</strong> <em>string</em> First address field for the Venue</li>
1293
- <li>
1294
- <strong>address2</strong> <em>string</em> Second address field for the Venue</li>
1295
- <li>
1296
- <strong>city</strong> <em>string</em> City the Venue is in</li>
1297
- <li>
1298
- <strong>country</strong> <em>string</em> Country the Venue is in</li>
1299
- <li>
1300
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1301
- <li>
1302
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1303
- <li>
1304
- <strong>latitude</strong> <em>float</em> Approximate Latitude for the Venue</li>
1305
- <li>
1306
- <strong>long_description</strong> <em>text</em> Description of the Venue</li>
1307
- <li>
1308
- <strong>longitude</strong> <em>float</em> Approximate Longitude for the Venue</li>
1309
- <li>
1310
- <strong>name</strong> <em>string</em> Name of the Venue</li>
1311
- <li>
1312
- <strong>metro_area_id</strong> <em>integer</em> Thrillcall ID of the Metro Area this Venue is in, if any</li>
1313
- <li>
1314
- <strong>state</strong> <em>string</em> State the Venue is in</li>
1315
- <li>
1316
- <strong>upcoming_events_count</strong> <em>integer</em> Number of upcoming events associated with this object</li>
1317
- <li>
1318
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1319
- <li>
1320
- <strong>postalcode</strong> <em>string</em> Postal code for the Venue</li>
1321
- <li>
1322
- <strong>phone_number</strong> <em>string</em> Phone number for the Venue (including country code)</li>
1323
- <li>
1324
- <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
1325
- <li>
1326
- <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
1327
- </ul><h3>GET /venues</h3>
1328
-
1329
- <p>Params:</p>
1330
-
1331
- <ul>
1332
- <li><strong><a href="#limit">limit</a></strong></li>
1333
- <li><strong><a href="#page">page</a></strong></li>
1334
- <li><strong><a href="#lat">lat</a></strong></li>
1335
- <li><strong><a href="#long">long</a></strong></li>
1336
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
1337
- <li><strong><a href="#radius">radius</a></strong></li>
1338
- </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1339
-
1340
- <div class="highlight">
1341
- <pre> <span class="c1">// Example: GET /api/v3/venues?limit=14&amp;api_key=1234567890abcdef</span>
1342
-
1343
- <span class="p">[</span>
1344
- <span class="p">{</span>
1345
- <span class="s2">"address1"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1346
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1347
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Guadalajara"</span><span class="p">,</span>
1348
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1349
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-05-09T09:29:23Z"</span><span class="p">,</span>
1350
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1351
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">20.666222</span><span class="p">,</span>
1352
- <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1353
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">103.352089</span><span class="p">,</span>
1354
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Fbolko"</span><span class="p">,</span>
1355
- <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1356
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1357
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Mexico_City"</span><span class="p">,</span>
1358
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1359
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T00:04:23Z"</span><span class="p">,</span>
1360
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1361
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1362
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1363
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
1364
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
1365
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-mobile.jpg"</span>
1366
- <span class="p">},</span>
1367
- <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1368
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"</span>
1369
- <span class="p">},</span>
1370
- <span class="p">{</span>
1371
- <span class="p">...</span>
1372
- <span class="p">},</span>
1373
- <span class="p">...</span>
1374
- <span class="p">]</span>
1375
- </pre>
1376
- </div>
1377
-
1378
-
1379
- <h3>GET /venue/:id</h3>
1380
-
1381
- <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1382
-
1383
- <p>Params:</p>
1384
-
1385
- <ul>
1386
- <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1387
- </ul><p>Returns: Venue <em>Hash</em></p>
1388
-
1389
- <div class="highlight">
1390
- <pre> <span class="c1">// Example: GET /api/v3/venue/51886?api_key=1234567890abcdef</span>
1391
-
1392
- <span class="p">{</span>
1393
- <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"201 Van Ness Avenue"</span><span class="p">,</span>
1394
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1395
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"San Francisco"</span><span class="p">,</span>
1396
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1397
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-28T17:59:32Z"</span><span class="p">,</span>
1398
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
1399
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.777402</span><span class="p">,</span>
1400
- <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1401
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.419815</span><span class="p">,</span>
1402
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Davies Symphony Hall"</span><span class="p">,</span>
1403
- <span class="s2">"phone_number"</span><span class="o">:</span> <span class="s2">"(415) 864-6000"</span><span class="p">,</span>
1404
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
1405
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span><span class="p">,</span>
1406
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">48</span><span class="p">,</span>
1407
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T03:13:27Z"</span><span class="p">,</span>
1408
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94102"</span><span class="p">,</span>
1409
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1410
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154"</span><span class="p">,</span>
1411
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154"</span><span class="p">,</span>
1412
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154"</span><span class="p">,</span>
1413
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"</span>
1414
- <span class="p">},</span>
1415
- <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1416
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"</span>
1417
- <span class="p">}</span>
1418
- </pre>
1419
- </div>
1420
-
1421
-
1422
- <h3>GET /venue/:id/events</h3>
1423
-
1424
- <p><strong>:id</strong> <em>integer</em> Thrillcall or Partner ID</p>
1425
-
1426
- <p>Params:</p>
1427
-
1428
- <ul>
1429
- <li><strong><a href="#limit">limit</a></strong></li>
1430
- <li><strong><a href="#page">page</a></strong></li>
1431
- <li><strong><a href="#time_zone">time_zone</a></strong></li>
1432
- <li><strong><a href="#min_date">min_date</a></strong></li>
1433
- <li><strong><a href="#max_date">max_date</a></strong></li>
1434
- <li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
1435
- <li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
1436
- <li><strong><a href="#use_partner_id">use_partner_id</a></strong></li>
1437
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1438
- <li><strong><a href="#must_have_tickets">must_have_tickets</a></strong></li>
1439
- <li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
1440
- <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1441
- <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1442
- </ul><p>Returns: <em>Array</em> of Events <em>Hash</em></p>
1443
-
1444
- <div class="highlight">
1445
- <pre> <span class="c1">// Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef</span>
1446
-
1447
- <span class="p">[</span>
1448
- <span class="p">{</span>
1449
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
1450
- <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1451
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
1452
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.7915</span><span class="p">,</span>
1453
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.413</span><span class="p">,</span>
1454
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Il Volo @ Masonic Center"</span><span class="p">,</span>
1455
- <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1456
- <span class="s2">"rumor"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1457
- <span class="s2">"start_date"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04Z"</span><span class="p">,</span>
1458
- <span class="s2">"starts_at"</span><span class="o">:</span> <span class="s2">"2012-09-30T02:30:04Z"</span><span class="p">,</span>
1459
- <span class="s2">"starts_at_time_trusted"</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span>
1460
- <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1461
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-29T01:35:57Z"</span><span class="p">,</span>
1462
- <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">63279</span><span class="p">,</span>
1463
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1464
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426"</span><span class="p">,</span>
1465
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426"</span><span class="p">,</span>
1466
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"</span>
1467
- <span class="p">},</span>
1468
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/1047075"</span><span class="p">,</span>
1469
- <span class="s2">"starts_at_local"</span><span class="o">:</span> <span class="s2">"2012-09-29T19:30:04-07:00"</span><span class="p">,</span>
1470
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Los_Angeles"</span>
1471
- <span class="s2">"status"</span><span class="o">:</span> <span class="s2">"confirmed"</span>
1472
- <span class="p">},</span>
1473
- <span class="p">{</span>
1474
- <span class="p">...</span>
1475
- <span class="p">},</span>
1476
- <span class="p">...</span>
1477
- <span class="p">]</span>
1478
- </pre>
1479
- </div>
1480
-
1481
-
1482
- <h3>GET /search/venues/:term</h3>
1483
-
1484
- <p><strong>:term</strong> <em>string</em> Arbitrary search string on the <strong>name</strong> field. (alphanumerics only, underscore matches underscore, use '+' for space)</p>
1485
-
1486
- <p>Params:</p>
1487
-
1488
- <ul>
1489
- <li><strong><a href="#limit">limit</a></strong></li>
1490
- <li><strong><a href="#page">page</a></strong></li>
1491
- <li><strong><a href="#lat">lat</a></strong></li>
1492
- <li><strong><a href="#long">long</a></strong></li>
1493
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
1494
- <li><strong><a href="#radius">radius</a></strong></li>
1495
- </ul><p>Returns: <em>Array</em> of Venues <em>Hash</em></p>
1496
-
1497
- <div class="highlight">
1498
- <pre> <span class="c1">// Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef</span>
1499
-
1500
- <span class="p">[</span>
1501
- <span class="p">{</span>
1502
- <span class="s2">"address1"</span><span class="o">:</span> <span class="s2">"525 W Riverview Ave"</span><span class="p">,</span>
1503
- <span class="s2">"address2"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1504
- <span class="s2">"city"</span><span class="o">:</span> <span class="s2">"Dayton"</span><span class="p">,</span>
1505
- <span class="s2">"country"</span><span class="o">:</span> <span class="s2">"US"</span><span class="p">,</span>
1506
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-06-12T14:12:53Z"</span><span class="p">,</span>
1507
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">33642</span><span class="p">,</span>
1508
- <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">39.765526</span><span class="p">,</span>
1509
- <span class="s2">"long_description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1510
- <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">84.203133</span><span class="p">,</span>
1511
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Dayton Masonic Center"</span><span class="p">,</span>
1512
- <span class="s2">"phone_number"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1513
- <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"OH"</span><span class="p">,</span>
1514
- <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/New_York"</span><span class="p">,</span>
1515
- <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1516
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-28T03:11:49Z"</span><span class="p">,</span>
1517
- <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"45405"</span><span class="p">,</span>
1518
- <span class="s2">"photos"</span><span class="o">:</span> <span class="p">{</span>
1519
- <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1520
- <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
1521
- <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
1522
- <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.development.tc-core.com/venue/_default/default-mobile.jpg"</span>
1523
- <span class="p">},</span>
1524
- <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">134</span><span class="p">,</span>
1525
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"</span>
1526
- <span class="p">},</span>
1527
- <span class="p">{</span>
1528
- <span class="p">...</span>
1529
- <span class="p">},</span>
1530
- <span class="p">...</span>
1531
- <span class="p">]</span>
1532
- </pre>
1533
- </div>
1534
-
1535
-
1536
- <h2>Tickets</h2>
1537
-
1538
- <p>Fields:</p>
1539
-
1540
- <ul>
1541
- <li>
1542
- <strong>created_at</strong> <em>string</em> ISO 8601 representation the time this object was created</li>
1543
- <li>
1544
- <strong>description</strong> <em>string</em> Long form description of the ticket</li>
1545
- <li>
1546
- <strong>event_id</strong> <em>integer</em> Thrillcall Event ID</li>
1547
- <li>
1548
- <strong>id</strong> <em>integer</em> Thrillcall ID</li>
1549
- <li>
1550
- <strong>marketing_text</strong> <em>string</em> Long form description of the ticket</li>
1551
- <li>
1552
- <strong>max_ticket_price</strong> <em>float</em> Maximum price for this ticket</li>
1553
- <li>
1554
- <strong>min_ticket_price</strong> <em>float</em> Minimum price for this ticket</li>
1555
- <li>
1556
- <strong>name</strong> <em>string</em> Name of this ticket</li>
1557
- <li>
1558
- <strong>on_sale_end_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes off sale</li>
1559
- <li>
1560
- <strong>on_sale_start_date</strong> <em>string</em> YYYY-MM-DD date when the ticket goes on sale</li>
1561
- <li>
1562
- <strong>seat_info</strong> <em>string</em> Additional info about the seat</li>
1563
- <li>
1564
- <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
1565
- <li>
1566
- <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
1567
- </ul><h3>GET /tickets</h3>
1568
-
1569
- <p>Params:</p>
1570
-
1571
- <ul>
1572
- <li><strong><a href="#limit">limit</a></strong></li>
1573
- <li><strong><a href="#page">page</a></strong></li>
1574
- <li><strong><a href="#time_zone">time_zone</a></strong></li>
1575
- <li><strong><a href="#min_date">min_date</a></strong></li>
1576
- <li><strong><a href="#max_date">max_date</a></strong></li>
1577
- <li><strong><a href="#min_updated_at">min_updated_at</a></strong></li>
1578
- <li><strong><a href="#max_updated_at">max_updated_at</a></strong></li>
1579
- <li><strong><a href="#lat">lat</a></strong></li>
1580
- <li><strong><a href="#long">long</a></strong></li>
1581
- <li><strong><a href="#postalcode">postalcode</a></strong></li>
1582
- <li><strong><a href="#radius">radius</a></strong></li>
1583
- <li><strong><a href="#ticket_type">ticket_type</a></strong></li>
1584
- <li><strong><a href="#show_disabled_events">show_disabled_events</a></strong></li>
1585
- <li><strong><a href="#show_unconfirmed_events">show_unconfirmed_events</a></strong></li>
1586
- <li><strong><a href="#show_rumor_events">show_rumor_events</a></strong></li>
1587
- </ul><p>Returns: <em>Array</em> of Tickets <em>Hash</em></p>
1588
-
1589
- <div class="highlight">
1590
- <pre> <span class="c1">// Example: GET /api/v3/tickets?limit=14&amp;api_key=1234567890abcdef</span>
1591
-
1592
- <span class="p">[</span>
1593
- <span class="p">{</span>
1594
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-12-06T00:19:59Z"</span><span class="p">,</span>
1595
- <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1596
- <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">455646</span><span class="p">,</span>
1597
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1598
- <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1599
- <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1600
- <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1601
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"General Onsale"</span><span class="p">,</span>
1602
- <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1603
- <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1604
- <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1605
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2009-09-22T22:58:37Z"</span><span class="p">,</span>
1606
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://www.livenation.com/edp/eventId/335800/?c=api-000157"</span>
1607
- <span class="p">},</span>
1608
- <span class="p">{</span>
1609
- <span class="p">...</span>
1610
- <span class="p">},</span>
1611
- <span class="p">...</span>
1612
- <span class="p">]</span>
1613
- </pre>
1614
- </div>
1615
-
1616
-
1617
- <h3>GET /ticket/:id</h3>
1618
-
1619
- <p><strong>:id</strong> <em>integer</em> Thrillcall ID</p>
1620
-
1621
- <p>Params:</p>
1622
-
1623
- <ul>
1624
- <li>None</li>
1625
- </ul><p>Returns: Ticket <em>Hash</em></p>
1626
-
1627
- <div class="highlight">
1628
- <pre> <span class="c1">// Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef</span>
1629
-
1630
- <span class="p">{</span>
1631
- <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
1632
- <span class="s2">"description"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1633
- <span class="s2">"event_id"</span><span class="o">:</span> <span class="mi">1047075</span><span class="p">,</span>
1634
- <span class="s2">"id"</span><span class="o">:</span> <span class="mi">819883</span><span class="p">,</span>
1635
- <span class="s2">"marketing_text"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1636
- <span class="s2">"max_ticket_price"</span><span class="o">:</span> <span class="mi">85</span><span class="p">,</span>
1637
- <span class="s2">"min_ticket_price"</span><span class="o">:</span> <span class="mi">29</span><span class="p">,</span>
1638
- <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Onsale to General Public"</span><span class="p">,</span>
1639
- <span class="s2">"on_sale_end_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1640
- <span class="s2">"on_sale_start_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1641
- <span class="s2">"seat_info"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1642
- <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2012-03-02T18:06:14Z"</span><span class="p">,</span>
1643
- <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://ticketsus.at/thrillcall?CTY=39&amp;DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&amp;brand=[=BRAND=]"</span>
1644
- <span class="p">}</span>
1645
- </pre>
1646
- </div>