thrillcall-api 0.0.6 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>