thrillcall-api 0.0.3 → 0.0.4

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.
data/Rakefile CHANGED
@@ -1,2 +1,12 @@
1
1
  require 'bundler'
2
2
  Bundler::GemHelper.install_tasks
3
+ require 'rspec/core/rake_task'
4
+
5
+ desc 'Default: run specs.'
6
+ task :default => :spec
7
+
8
+ desc "Run specs"
9
+ RSpec::Core::RakeTask.new do |t|
10
+ t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
11
+ # Put spec opts in a file named .rspec in root
12
+ end
data/docs/API.html CHANGED
@@ -117,6 +117,8 @@ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be di
117
117
  <p><em>Default: none</em></p>
118
118
 
119
119
  <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>
120
+
121
+ <p>For Person queries, this specifies the latitude of the person's location.</p>
120
122
  </li>
121
123
  <li>
122
124
  <p><a name="long"></a><strong>long</strong> <em>float</em></p>
@@ -124,6 +126,8 @@ Access over an insecure HTTP (port 80) endpoint is now deprecated and will be di
124
126
  <p><em>Default: none</em></p>
125
127
 
126
128
  <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>
129
+
130
+ <p>For Person queries, this specifies the longitude of the person's location.</p>
127
131
  </li>
128
132
  <li>
129
133
  <p><a name="postalcode"></a><strong>postalcode</strong> <em>string (format: length &gt;= 5)</em></p>
@@ -185,14 +189,29 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
185
189
  <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>
186
190
  </li>
187
191
  <li>
188
- <p><a name="login"></a><strong>login</strong> <em>string</em></p>
192
+ <p><a name="email"></a><strong>email</strong> <em>string</em></p>
189
193
 
190
- <p>Required to authenticate/register a user.</p>
194
+ <p>The email address associated with a user, required for registration.</p>
191
195
  </li>
192
196
  <li>
193
197
  <p><a name="password"></a><strong>password</strong> <em>string (format: 40 &gt;= length &gt;= 5)</em></p>
194
198
 
195
- <p>Required to authenticate/register a user.</p>
199
+ <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>
200
+ </li>
201
+ <li>
202
+ <p><a name="provider"></a><strong>provider</strong> <em>string</em></p>
203
+
204
+ <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>
205
+ </li>
206
+ <li>
207
+ <p><a name="uid"></a><strong>uid</strong> <em>string</em></p>
208
+
209
+ <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>
210
+ </li>
211
+ <li>
212
+ <p><a name="token"></a><strong>token</strong> <em>string</em></p>
213
+
214
+ <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>
196
215
  </li>
197
216
  <li>
198
217
  <p><a name="first_name"></a><strong>first_name</strong> <em>string (format: 50 &gt;= length &gt;= 2)</em></p>
@@ -205,14 +224,19 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
205
224
  <p>Optional for registering a user.</p>
206
225
  </li>
207
226
  <li>
208
- <p><a name="email"></a><strong>email</strong> <em>string</em></p>
227
+ <p><a name="gender"></a><strong>gender</strong> <em>string (format: length == 1)</em></p>
209
228
 
210
- <p>Required to register a user.</p>
229
+ <p>Optional for registering a user.</p>
211
230
  </li>
212
231
  <li>
213
- <p><a name="gender"></a><strong>gender</strong> <em>string (format: length == 1)</em></p>
232
+ <p><a name="location_name"></a><strong>location_name</strong> <em>string (format: "City, ST or City, State", length &gt; 0))</em></p>
214
233
 
215
- <p>Optional for registering a user.</p>
234
+ <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>
235
+ </li>
236
+ <li>
237
+ <p><a name="referral_code"></a><strong>referral_code</strong> <em>string</em></p>
238
+
239
+ <p>The referral code to be used during registration. Both the owner of the code as well as the new user will receive a point on their referral counts.</p>
216
240
  </li>
217
241
  </ul><h2>Artists</h2>
218
242
 
@@ -234,6 +258,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
234
258
  <li>
235
259
  <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
236
260
  <li>
261
+ <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
262
+ <li>
237
263
  <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
238
264
  </ul><h3>GET /artists</h3>
239
265
 
@@ -257,6 +283,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
257
283
  <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">61</span><span class="p">,</span>
258
284
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
259
285
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-26T16:49:20Z"</span><span class="p">,</span>
286
+ <span class="s2">"photos"</span><span class="o">:</span>
287
+ <span class="p">{</span>
288
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
289
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
290
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
291
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
292
+ <span class="p">},</span>
260
293
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Hyler_Jones_Proteges"</span>
261
294
  <span class="p">},</span>
262
295
  <span class="p">{</span>
@@ -289,6 +322,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
289
322
  <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
290
323
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
291
324
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
325
+ <span class="s2">"photos"</span><span class="o">:</span>
326
+ <span class="p">{</span>
327
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
328
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
329
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
330
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
331
+ <span class="p">},</span>
292
332
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
293
333
  <span class="p">}</span>
294
334
  </pre>
@@ -339,6 +379,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
339
379
  <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
340
380
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:01:56Z"</span><span class="p">,</span>
341
381
  <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">10116</span><span class="p">,</span>
382
+ <span class="s2">"photos"</span><span class="o">:</span>
383
+ <span class="p">{</span>
384
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
385
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
386
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
387
+ <span class="p">},</span>
342
388
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/862618"</span>
343
389
  <span class="p">},</span>
344
390
  <span class="p">{</span>
@@ -373,6 +419,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
373
419
  <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
374
420
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
375
421
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
422
+ <span class="s2">"photos"</span><span class="o">:</span>
423
+ <span class="p">{</span>
424
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
425
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
426
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
427
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
428
+ <span class="p">},</span>
376
429
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
377
430
  <span class="p">},</span>
378
431
  <span class="p">{</span>
@@ -424,6 +477,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
424
477
  <li>
425
478
  <strong>venue_id</strong> <em>integer</em> Thrillcall Venue ID</li>
426
479
  <li>
480
+ <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
481
+ <li>
427
482
  <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
428
483
  </ul><h3>GET /events</h3>
429
484
 
@@ -466,6 +521,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
466
521
  <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
467
522
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
468
523
  <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
524
+ <span class="s2">"photos"</span><span class="o">:</span>
525
+ <span class="p">{</span>
526
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
527
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
528
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
529
+ <span class="p">},</span>
469
530
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
470
531
  <span class="p">},</span>
471
532
  <span class="p">{</span>
@@ -508,6 +569,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
508
569
  <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
509
570
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T04:00:41Z"</span><span class="p">,</span>
510
571
  <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
572
+ <span class="s2">"photos"</span><span class="o">:</span>
573
+ <span class="p">{</span>
574
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
575
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
576
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
577
+ <span class="p">},</span>
511
578
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/858707"</span>
512
579
  <span class="p">}</span>
513
580
  </pre>
@@ -537,6 +604,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
537
604
  <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
538
605
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">8</span><span class="p">,</span>
539
606
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-20T19:12:57Z"</span><span class="p">,</span>
607
+ <span class="s2">"photos"</span><span class="o">:</span>
608
+ <span class="p">{</span>
609
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
610
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
611
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
612
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
613
+ <span class="p">},</span>
540
614
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/The_Sea_and_Cake"</span>
541
615
  <span class="p">},</span>
542
616
  <span class="p">{</span>
@@ -576,6 +650,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
576
650
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
577
651
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
578
652
  <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
653
+ <span class="s2">"photos"</span><span class="o">:</span>
654
+ <span class="p">{</span>
655
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
656
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
657
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
658
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
659
+ <span class="p">}</span>
579
660
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
580
661
  <span class="p">}</span>
581
662
  </pre>
@@ -713,6 +794,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
713
794
  <span class="s2">"primary_genre_id"</span><span class="o">:</span> <span class="mi">27</span><span class="p">,</span>
714
795
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
715
796
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-03T22:14:36Z"</span><span class="p">,</span>
797
+ <span class="s2">"photos"</span><span class="o">:</span>
798
+ <span class="p">{</span>
799
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-thumbnail.jpg"</span><span class="p">,</span>
800
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-medium.jpg"</span><span class="p">,</span>
801
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-large.jpg"</span><span class="p">,</span>
802
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/artist/_default/default-mobile.jpg"</span>
803
+ <span class="p">},</span>
716
804
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/artist/Espers"</span>
717
805
  <span class="p">},</span>
718
806
  <span class="p">{</span>
@@ -746,6 +834,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
746
834
  <li>
747
835
  <strong>state</strong> <em>string</em> State of the Metro Area</li>
748
836
  <li>
837
+ <strong>time_zone</strong> <em>string</em> Time zone of the Metro Area</li>
838
+ <li>
749
839
  <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
750
840
  <li>
751
841
  <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
@@ -771,6 +861,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
771
861
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">87.6324</span><span class="p">,</span>
772
862
  <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
773
863
  <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"IL"</span><span class="p">,</span>
864
+ <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Chicago"</span><span class="p">,</span>
774
865
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
775
866
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/chicago"</span>
776
867
  <span class="p">},</span>
@@ -805,6 +896,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
805
896
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.42</span><span class="p">,</span>
806
897
  <span class="s2">"radius"</span><span class="o">:</span> <span class="mi">50</span><span class="p">,</span>
807
898
  <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
899
+ <span class="s2">"time_zone"</span><span class="o">:</span> <span class="s2">"America/Chicago"</span><span class="p">,</span>
808
900
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-07-05T23:11:24Z"</span><span class="p">,</span>
809
901
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/live-music/san-francisco"</span>
810
902
  <span class="p">}</span>
@@ -852,6 +944,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
852
944
  <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
853
945
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-09-28T03:51:22Z"</span><span class="p">,</span>
854
946
  <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">51886</span><span class="p">,</span>
947
+ <span class="s2">"photos"</span><span class="o">:</span>
948
+ <span class="p">{</span>
949
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
950
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
951
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
952
+ <span class="p">},</span>
855
953
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/831330"</span>
856
954
  <span class="p">},</span>
857
955
  <span class="p">{</span>
@@ -865,6 +963,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
865
963
 
866
964
  <h2>Person</h2>
867
965
 
966
+ <p><strong>Note:</strong> Your API key requires the api_auth permission to access the endpoints associated with this object.</p>
967
+
868
968
  <p>Fields:</p>
869
969
 
870
970
  <ul>
@@ -879,7 +979,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
879
979
  <li>
880
980
  <strong>last_name</strong> <em>string</em> Last name of the Person</li>
881
981
  <li>
882
- <strong>login</strong> <em>string</em> Login of the Person</li>
982
+ <strong>login</strong> <em>string</em> Login (Email Address) of the Person</li>
883
983
  <li>
884
984
  <strong>updated_at</strong> <em>string</em> ISO 8601 representation of last time this object was updated</li>
885
985
  <li>
@@ -889,15 +989,28 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
889
989
  <li>
890
990
  <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
891
991
  <li>
892
- <strong>postalcode</strong> <em>string</em> Postalcode of the Person</li>
992
+ <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
893
993
  </ul><h3>POST /person/signin</h3>
894
994
 
895
995
  <p>Params:</p>
896
996
 
897
997
  <ul>
898
- <li><strong><a href="#login">login</a></strong></li>
998
+ <li><strong><a href="#email">email</a></strong></li>
899
999
  <li><strong><a href="#password">password</a></strong></li>
900
- </ul><p>Returns: Person <em>Hash</em></p>
1000
+ <li><strong><a href="#provider">provider</a></strong></li>
1001
+ <li><strong><a href="#uid">uid</a></strong></li>
1002
+ <li><strong><a href="#token">token</a></strong></li>
1003
+ <li><strong><a href="#first_name">first_name</a></strong></li>
1004
+ <li><strong><a href="#last_name">last_name</a></strong></li>
1005
+ <li><strong><a href="#location_name">location_name</a></strong></li>
1006
+ <li><strong><a href="#lat">lat</a></strong></li>
1007
+ <li><strong><a href="#long">long</a></strong></li>
1008
+ <li><strong><a href="#referral_code">referral_code</a></strong></li>
1009
+ </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>
1010
+
1011
+ <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>
1012
+
1013
+ <p>Returns: Person <em>Hash</em></p>
901
1014
 
902
1015
  <div class="highlight">
903
1016
  <pre> <span class="c1">// Example: POST /api/v2/person/signin</span>
@@ -912,6 +1025,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
912
1025
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
913
1026
  <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
914
1027
  <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1028
+ <span class="s2">"photos"</span><span class="o">:</span>
1029
+ <span class="p">{</span>
1030
+ <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
1031
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1032
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-medium.jpg"</span>
1033
+ <span class="p">},</span>
915
1034
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
916
1035
  <span class="p">}</span>
917
1036
  </pre>
@@ -929,6 +1048,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
929
1048
  <li><strong><a href="#email">email</a></strong></li>
930
1049
  <li><strong><a href="#password">password</a></strong></li>
931
1050
  <li><strong><a href="#postalcode">postalcode</a></strong></li>
1051
+ <li><strong><a href="#referral_code">referral_code</a></strong></li>
932
1052
  </ul><p>Returns: Person <em>Hash</em></p>
933
1053
 
934
1054
  <div class="highlight">
@@ -944,6 +1064,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
944
1064
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-11-09T19:09:23Z"</span><span class="p">,</span>
945
1065
  <span class="s2">"referral_code"</span><span class="o">:</span> <span class="s2">"fhskjfhk3j43h43hjkh"</span><span class="p">,</span>
946
1066
  <span class="s2">"referral_code_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1067
+ <span class="s2">"photos"</span><span class="o">:</span>
1068
+ <span class="p">{</span>
1069
+ <span class="s2">"small_thumb"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-small_thumb.jpg"</span><span class="p">,</span>
1070
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1071
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/person/_default/default-medium.jpg"</span>
1072
+ <span class="p">},</span>
947
1073
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94104"</span>
948
1074
  <span class="p">}</span>
949
1075
  </pre>
@@ -970,6 +1096,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
970
1096
  <li>
971
1097
  <strong>latitude</strong> <em>float</em> Approximate Latitude for the Venue</li>
972
1098
  <li>
1099
+ <strong>long_description</strong> <em>text</em> Description of the Venue</li>
1100
+ <li>
973
1101
  <strong>longitude</strong> <em>float</em> Approximate Longitude for the Venue</li>
974
1102
  <li>
975
1103
  <strong>name</strong> <em>string</em> Name of the Venue</li>
@@ -984,6 +1112,8 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
984
1112
  <li>
985
1113
  <strong>postalcode</strong> <em>string</em> Postal code for the Venue</li>
986
1114
  <li>
1115
+ <strong>photos</strong> <em>hash</em> A hash of image urls of the primary photo available for this object in different styles</li>
1116
+ <li>
987
1117
  <strong>url</strong> <em>string</em> URL for this object on Thrillcall</li>
988
1118
  </ul><h3>GET /venues</h3>
989
1119
 
@@ -1010,12 +1140,20 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1010
1140
  <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2000-11-09T19:09:23Z"</span><span class="p">,</span>
1011
1141
  <span class="s2">"id"</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
1012
1142
  <span class="s2">"latitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1143
+ <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
1013
1144
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1014
1145
  <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Fbolko"</span><span class="p">,</span>
1015
1146
  <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"MX"</span><span class="p">,</span>
1016
1147
  <span class="s2">"upcoming_events_count"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1017
1148
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2010-03-28T17:24:20Z"</span><span class="p">,</span>
1018
1149
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
1150
+ <span class="s2">"photos"</span><span class="o">:</span>
1151
+ <span class="p">{</span>
1152
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1153
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
1154
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
1155
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
1156
+ <span class="p">}</span>
1019
1157
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"</span>
1020
1158
  <span class="p">},</span>
1021
1159
  <span class="p">{</span>
@@ -1048,6 +1186,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1048
1186
  <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1049
1187
  <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1050
1188
  <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1189
+ <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
1051
1190
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1052
1191
  <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1053
1192
  <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
@@ -1055,6 +1194,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1055
1194
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1056
1195
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1057
1196
  <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1197
+ <span class="s2">"photos"</span><span class="o">:</span>
1198
+ <span class="p">{</span>
1199
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1200
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
1201
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
1202
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
1203
+ <span class="p">}</span>
1058
1204
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
1059
1205
  <span class="p">}</span>
1060
1206
  </pre>
@@ -1089,6 +1235,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1089
1235
  <span class="s2">"festival"</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span>
1090
1236
  <span class="s2">"id"</span><span class="o">:</span> <span class="mi">824614</span><span class="p">,</span>
1091
1237
  <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.8016</span><span class="p">,</span>
1238
+ <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
1092
1239
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">80.4462</span><span class="p">,</span>
1093
1240
  <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Colt Ford @ West Virginia State Fair"</span><span class="p">,</span>
1094
1241
  <span class="s2">"on_sale_date"</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
@@ -1097,6 +1244,12 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1097
1244
  <span class="s2">"unconfirmed_location"</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
1098
1245
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-06-24T05:10:05Z"</span><span class="p">,</span>
1099
1246
  <span class="s2">"venue_id"</span><span class="o">:</span> <span class="mi">32065</span><span class="p">,</span>
1247
+ <span class="s2">"photos"</span><span class="o">:</span>
1248
+ <span class="p">{</span>
1249
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1250
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-large.jpg"</span><span class="p">,</span>
1251
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/event/_default/default-mobile.jpg"</span>
1252
+ <span class="p">},</span>
1100
1253
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/event/824614"</span>
1101
1254
  <span class="p">},</span>
1102
1255
  <span class="p">{</span>
@@ -1135,6 +1288,7 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1135
1288
  <span class="s2">"created_at"</span><span class="o">:</span> <span class="s2">"2008-04-21T16:52:31Z"</span><span class="p">,</span>
1136
1289
  <span class="s2">"id"</span><span class="o">:</span> <span class="mi">27418</span><span class="p">,</span>
1137
1290
  <span class="s2">"latitude"</span><span class="o">:</span> <span class="mf">37.784796</span><span class="p">,</span>
1291
+ <span class="s2">"long_description"</span><span class="o">:</span> <span class="s2">"Description of the venue"</span><span class="p">,</span>
1138
1292
  <span class="s2">"longitude"</span><span class="o">:</span> <span class="o">-</span><span class="mf">122.418819</span><span class="p">,</span>
1139
1293
  <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"Great American Music Hall"</span><span class="p">,</span>
1140
1294
  <span class="s2">"state"</span><span class="o">:</span> <span class="s2">"CA"</span><span class="p">,</span>
@@ -1142,6 +1296,13 @@ If latitude (<strong><a href="#lat">lat</a></strong>) and longitude (<strong><a
1142
1296
  <span class="s2">"updated_at"</span><span class="o">:</span> <span class="s2">"2011-01-20T21:04:37Z"</span><span class="p">,</span>
1143
1297
  <span class="s2">"postalcode"</span><span class="o">:</span> <span class="s2">"94109"</span><span class="p">,</span>
1144
1298
  <span class="s2">"metro_area_id"</span><span class="o">:</span> <span class="mi">105</span><span class="p">,</span>
1299
+ <span class="s2">"photos"</span><span class="o">:</span>
1300
+ <span class="p">{</span>
1301
+ <span class="s2">"thumbnail"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-thumbnail.jpg"</span><span class="p">,</span>
1302
+ <span class="s2">"medium"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-medium.jpg"</span><span class="p">,</span>
1303
+ <span class="s2">"large"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-large.jpg"</span><span class="p">,</span>
1304
+ <span class="s2">"mobile"</span><span class="o">:</span> <span class="s2">"http://i.tc-core.com/venue/_default/default-mobile.jpg"</span>
1305
+ <span class="p">}</span>
1145
1306
  <span class="s2">"url"</span><span class="o">:</span> <span class="s2">"http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"</span>
1146
1307
  <span class="p">},</span>
1147
1308
  <span class="p">{</span>
data/docs/API.md CHANGED
@@ -45,12 +45,16 @@ These are valid parameters for any endpoint, however, they will only be used by
45
45
 
46
46
  If latitude (**[lat](#lat)**) and longitude (**[long](#long)**) if both are specified, results will be within **[radius](#radius)** of this location.
47
47
 
48
+ For Person queries, this specifies the latitude of the person's location.
49
+
48
50
  - <a name="long" />**long** _float_
49
51
 
50
52
  _Default: none_
51
53
 
52
54
  If latitude (**[lat](#lat)**) and longitude (**[long](#long)**) if both are specified, results will be within **[radius](#radius)** of this location.
53
55
 
56
+ For Person queries, this specifies the longitude of the person's location.
57
+
54
58
  - <a name="postalcode" />**postalcode** _string (format: length >= 5)_
55
59
 
56
60
  _Default: none_
@@ -102,13 +106,25 @@ These are valid parameters for any endpoint, however, they will only be used by
102
106
 
103
107
  If set, will filter Artist results to only those with the specified **[primary\_genre\_id](#primary_genre_id)**
104
108
 
105
- - <a name="login" />**login** _string_
109
+ - <a name="email" />**email** _string_
106
110
 
107
- Required to authenticate/register a user.
111
+ The email address associated with a user, required for registration.
108
112
 
109
113
  - <a name="password" />**password** _string (format: 40 >= length >= 5)_
110
114
 
111
- Required to authenticate/register a user.
115
+ The user's password. Must be supplied along with **[email](#email)** unless using **[provider](#provider)** / **[uid](#uid)** / **[token](#token)** auth.
116
+
117
+ - <a name="provider" />**provider** _string_
118
+
119
+ The name of the authentication provider (e.g. "facebook"). Must be supplied along with **[uid](#uid)** and **[token](#token)** unless using **[email](#email)**/**[password](#password)** auth.
120
+
121
+ - <a name="uid" />**uid** _string_
122
+
123
+ The user's ID with **[provider](#provider)**. Must be supplied along with **[provider](#provider)** and **[token](#token)** unless using **[email](#email)**/**[password](#password)** auth.
124
+
125
+ - <a name="token" />**token** _string_
126
+
127
+ The user's authentication token with **[provider](#provider)**. Must be supplied along with **[provider](#provider)** and **[uid](#uid)** unless using **[email](#email)**/**[password](#password)** auth.
112
128
 
113
129
  - <a name="first_name" />**first\_name** _string (format: 50 >= length >= 2)_
114
130
 
@@ -118,14 +134,19 @@ These are valid parameters for any endpoint, however, they will only be used by
118
134
 
119
135
  Optional for registering a user.
120
136
 
121
- - <a name="email" />**email** _string_
122
-
123
- Required to register a user.
124
-
125
137
  - <a name="gender" />**gender** _string (format: length == 1)_
126
138
 
127
139
  Optional for registering a user.
128
140
 
141
+ - <a name="location_name" />**location\_name** _string (format: "City, ST or City, State", length > 0))_
142
+
143
+ The name of the user's location when auto-registering. Either this or **[lat](#lat)** / **[long](#long)** must be provided.
144
+
145
+ - <a name="referral_code" />**referral\_code** _string_
146
+
147
+ The referral code to be used during registration. Both the owner of the code as well as the new user will receive a point on their referral counts.
148
+
149
+
129
150
  ## Artists
130
151
  Fields:
131
152
 
@@ -136,6 +157,7 @@ Fields:
136
157
  - **primary\_genre\_id** _integer_ The Thrillcall ID for this artist's primary Genre
137
158
  - **upcoming\_events\_count** _integer_ Number of upcoming events associated with this object
138
159
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
160
+ - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
139
161
  - **url** _string_ URL for this object on Thrillcall
140
162
 
141
163
 
@@ -160,6 +182,13 @@ Returns: _Array_ of Artists _Hash_
160
182
  "primary_genre_id": 61,
161
183
  "upcoming_events_count": 0,
162
184
  "updated_at": "2010-03-26T16:49:20Z",
185
+ "photos":
186
+ {
187
+ "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
188
+ "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
189
+ "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
190
+ "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
191
+ },
163
192
  "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
164
193
  },
165
194
  {
@@ -189,6 +218,13 @@ Returns: Artist _Hash_
189
218
  "primary_genre_id": 27,
190
219
  "upcoming_events_count": 8,
191
220
  "updated_at": "2011-09-20T19:12:57Z",
221
+ "photos":
222
+ {
223
+ "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
224
+ "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
225
+ "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
226
+ "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
227
+ },
192
228
  "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
193
229
  }
194
230
  ```
@@ -236,6 +272,12 @@ Returns: _Array_ of Events _Hash_
236
272
  "unconfirmed_location": 0,
237
273
  "updated_at": "2011-09-28T04:01:56Z",
238
274
  "venue_id": 10116,
275
+ "photos":
276
+ {
277
+ "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
278
+ "large": "http://i.tc-core.com/event/_default/default-large.jpg",
279
+ "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
280
+ },
239
281
  "url": "http://thrillcall.com/event/862618"
240
282
  },
241
283
  {
@@ -267,6 +309,13 @@ Returns: _Array_ of Artists _Hash_
267
309
  "primary_genre_id": 27,
268
310
  "upcoming_events_count": 8,
269
311
  "updated_at": "2011-09-20T19:12:57Z",
312
+ "photos":
313
+ {
314
+ "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
315
+ "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
316
+ "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
317
+ "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
318
+ },
270
319
  "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
271
320
  },
272
321
  {
@@ -296,6 +345,7 @@ Fields:
296
345
  - **unconfirmed\_location** _integer_ If 1, the location if this event is unconfirmed
297
346
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
298
347
  - **venue\_id** _integer_ Thrillcall Venue ID
348
+ - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
299
349
  - **url** _string_ URL for this object on Thrillcall
300
350
 
301
351
 
@@ -339,6 +389,12 @@ Returns: _Array_ of Events _Hash_
339
389
  "unconfirmed_location": 0,
340
390
  "updated_at": "2011-09-28T04:00:41Z",
341
391
  "venue_id": 27418,
392
+ "photos":
393
+ {
394
+ "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
395
+ "large": "http://i.tc-core.com/event/_default/default-large.jpg",
396
+ "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
397
+ },
342
398
  "url": "http://thrillcall.com/event/858707"
343
399
  },
344
400
  {
@@ -378,6 +434,12 @@ Returns: Event _Hash_
378
434
  "unconfirmed_location": 0,
379
435
  "updated_at": "2011-09-28T04:00:41Z",
380
436
  "venue_id": 27418,
437
+ "photos":
438
+ {
439
+ "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
440
+ "large": "http://i.tc-core.com/event/_default/default-large.jpg",
441
+ "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
442
+ },
381
443
  "url": "http://thrillcall.com/event/858707"
382
444
  }
383
445
  ```
@@ -404,6 +466,13 @@ Returns: _Array_ of Artists _Hash_
404
466
  "primary_genre_id": 27,
405
467
  "upcoming_events_count": 8,
406
468
  "updated_at": "2011-09-20T19:12:57Z",
469
+ "photos":
470
+ {
471
+ "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
472
+ "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
473
+ "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
474
+ "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
475
+ },
407
476
  "url": "http://thrillcall.com/artist/The_Sea_and_Cake"
408
477
  },
409
478
  {
@@ -440,6 +509,13 @@ Returns: Venue _Hash_
440
509
  "updated_at": "2011-01-20T21:04:37Z",
441
510
  "postalcode": "94109",
442
511
  "metro_area_id": 105,
512
+ "photos":
513
+ {
514
+ "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
515
+ "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
516
+ "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
517
+ "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
518
+ }
443
519
  "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
444
520
  }
445
521
  ```
@@ -559,6 +635,13 @@ Returns: _Array_ of Artists _Hash_
559
635
  "primary_genre_id": 27,
560
636
  "upcoming_events_count": 1,
561
637
  "updated_at": "2011-01-03T22:14:36Z",
638
+ "photos":
639
+ {
640
+ "thumbnail": "http://i.tc-core.com/artist/_default/default-thumbnail.jpg",
641
+ "medium": "http://i.tc-core.com/artist/_default/default-medium.jpg",
642
+ "large": "http://i.tc-core.com/artist/_default/default-large.jpg",
643
+ "mobile": "http://i.tc-core.com/artist/_default/default-mobile.jpg"
644
+ },
562
645
  "url": "http://thrillcall.com/artist/Espers"
563
646
  },
564
647
  {
@@ -579,6 +662,7 @@ Fields:
579
662
  - **longitude** _float_ Longitude of the Metro Area
580
663
  - **radius** _integer_ Radius of the Metro Area from the Lat/Long center
581
664
  - **state** _string_ State of the Metro Area
665
+ - **time\_zone** _string_ Time zone of the Metro Area
582
666
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
583
667
  - **url** _string_ URL for this object on Thrillcall
584
668
 
@@ -603,6 +687,7 @@ Returns: _Array_ of Metro Areas _Hash_
603
687
  "longitude": -87.6324,
604
688
  "radius": 50,
605
689
  "state": "IL",
690
+ "time_zone": "America/Chicago",
606
691
  "updated_at": "2011-07-05T23:11:24Z",
607
692
  "url": "http://thrillcall.com/live-music/chicago"
608
693
  },
@@ -634,6 +719,7 @@ Returns: Metro Area _Hash_
634
719
  "longitude": -122.42,
635
720
  "radius": 50,
636
721
  "state": "CA",
722
+ "time_zone": "America/Chicago",
637
723
  "updated_at": "2011-07-05T23:11:24Z",
638
724
  "url": "http://thrillcall.com/live-music/san-francisco"
639
725
  }
@@ -678,6 +764,12 @@ Returns: _Array_ of Metro Areas _Hash_
678
764
  "unconfirmed_location": 0,
679
765
  "updated_at": "2011-09-28T03:51:22Z",
680
766
  "venue_id": 51886,
767
+ "photos":
768
+ {
769
+ "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
770
+ "large": "http://i.tc-core.com/event/_default/default-large.jpg",
771
+ "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
772
+ },
681
773
  "url": "http://thrillcall.com/event/831330"
682
774
  },
683
775
  {
@@ -688,6 +780,8 @@ Returns: _Array_ of Metro Areas _Hash_
688
780
  ```
689
781
 
690
782
  ## Person
783
+ **Note:** Your API key requires the api\_auth permission to access the endpoints associated with this object.
784
+
691
785
  Fields:
692
786
 
693
787
  - **created\_at** _string_ ISO 8601 representation the time this object was created
@@ -695,18 +789,31 @@ Fields:
695
789
  - **gender** _string_ Gender of the Person
696
790
  - **id** _integer_ Thrillcall ID
697
791
  - **last\_name** _string_ Last name of the Person
698
- - **login** _string_ Login of the Person
792
+ - **login** _string_ Login (Email Address) of the Person
699
793
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
700
794
  - **referral\_code** _string_ Referral code of the Person
701
795
  - **referral\_code\_count** _integer_ Number of Referral code used for the Person
702
796
  - **postalcode** _string_ Postalcode of the Person
703
- - **postalcode** _string_ Postalcode of the Person
797
+ - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
704
798
 
705
799
  ### POST /person/signin
706
800
  Params:
707
801
 
708
- - **[login](#login)**
802
+ - **[email](#email)**
709
803
  - **[password](#password)**
804
+ - **[provider](#provider)**
805
+ - **[uid](#uid)**
806
+ - **[token](#token)**
807
+ - **[first\_name](#first_name)**
808
+ - **[last\_name](#last_name)**
809
+ - **[location\_name](#location_name)**
810
+ - **[lat](#lat)**
811
+ - **[long](#long)**
812
+ - **[referral\_code](#referral_code)**
813
+
814
+ Use either **[email](#email)** / **[password](#password)** or **[provider](#provider)** / **[uid](#uid)** / **[token](#token)**.
815
+
816
+ May perform registration ("signup") automatically if using **[provider](#provider)** / **[uid](#uid)** / **[token](#token)** when no match is found and name, location, and **[referral_code](#referral_code)** are also provided.
710
817
 
711
818
  Returns: Person _Hash_
712
819
 
@@ -723,6 +830,12 @@ Returns: Person _Hash_
723
830
  "updated_at": "2011-11-09T19:09:23Z",
724
831
  "referral_code": "fhskjfhk3j43h43hjkh",
725
832
  "referral_code_count": 0,
833
+ "photos":
834
+ {
835
+ "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
836
+ "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
837
+ "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
838
+ },
726
839
  "postalcode": "94104"
727
840
  }
728
841
  ```
@@ -736,6 +849,7 @@ Params:
736
849
  - **[email](#email)**
737
850
  - **[password](#password)**
738
851
  - **[postalcode](#postalcode)**
852
+ - **[referral\_code](#referral_code)**
739
853
 
740
854
  Returns: Person _Hash_
741
855
 
@@ -752,6 +866,12 @@ Returns: Person _Hash_
752
866
  "updated_at": "2011-11-09T19:09:23Z",
753
867
  "referral_code": "fhskjfhk3j43h43hjkh",
754
868
  "referral_code_count": 0,
869
+ "photos":
870
+ {
871
+ "small_thumb": "http://i.tc-core.com/person/_default/default-small_thumb.jpg",
872
+ "thumbnail": "http://i.tc-core.com/person/_default/default-thumbnail.jpg",
873
+ "medium": "http://i.tc-core.com/person/_default/default-medium.jpg"
874
+ },
755
875
  "postalcode": "94104"
756
876
  }
757
877
  ```
@@ -767,6 +887,7 @@ Fields:
767
887
  - **created\_at** _string_ ISO 8601 representation the time this object was created
768
888
  - **id** _integer_ Thrillcall ID
769
889
  - **latitude** _float_ Approximate Latitude for the Venue
890
+ - **long\_description** _text_ Description of the Venue
770
891
  - **longitude** _float_ Approximate Longitude for the Venue
771
892
  - **name** _string_ Name of the Venue
772
893
  - **metro\_area\_id** _integer_ Thrillcall ID of the Metro Area this Venue is in, if any
@@ -774,6 +895,7 @@ Fields:
774
895
  - **upcoming\_events\_count** _integer_ Number of upcoming events associated with this object
775
896
  - **updated\_at** _string_ ISO 8601 representation of last time this object was updated
776
897
  - **postalcode** _string_ Postal code for the Venue
898
+ - **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
777
899
  - **url** _string_ URL for this object on Thrillcall
778
900
 
779
901
 
@@ -801,12 +923,20 @@ Returns: _Array_ of Venues _Hash_
801
923
  "created_at": "2000-11-09T19:09:23Z",
802
924
  "id": 1,
803
925
  "latitude": null,
926
+ "long_description": "Description of the venue",
804
927
  "longitude": null,
805
928
  "name": "Fbolko",
806
929
  "state": "MX",
807
930
  "upcoming_events_count": 0,
808
931
  "updated_at": "2010-03-28T17:24:20Z",
809
932
  "postalcode": null,
933
+ "photos":
934
+ {
935
+ "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
936
+ "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
937
+ "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
938
+ "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
939
+ }
810
940
  "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
811
941
  },
812
942
  {
@@ -837,6 +967,7 @@ Returns: Venue _Hash_
837
967
  "created_at": "2008-04-21T16:52:31Z",
838
968
  "id": 27418,
839
969
  "latitude": 37.784796,
970
+ "long_description": "Description of the venue",
840
971
  "longitude": -122.418819,
841
972
  "name": "Great American Music Hall",
842
973
  "state": "CA",
@@ -844,6 +975,13 @@ Returns: Venue _Hash_
844
975
  "updated_at": "2011-01-20T21:04:37Z",
845
976
  "postalcode": "94109",
846
977
  "metro_area_id": 105,
978
+ "photos":
979
+ {
980
+ "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
981
+ "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
982
+ "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
983
+ "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
984
+ }
847
985
  "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
848
986
  }
849
987
  ```
@@ -875,6 +1013,7 @@ Returns: _Array_ of Events _Hash_
875
1013
  "festival": false,
876
1014
  "id": 824614,
877
1015
  "latitude": 37.8016,
1016
+ "long_description": "Description of the venue",
878
1017
  "longitude": -80.4462,
879
1018
  "name": "Colt Ford @ West Virginia State Fair",
880
1019
  "on_sale_date": null,
@@ -883,6 +1022,12 @@ Returns: _Array_ of Events _Hash_
883
1022
  "unconfirmed_location": 0,
884
1023
  "updated_at": "2011-06-24T05:10:05Z",
885
1024
  "venue_id": 32065,
1025
+ "photos":
1026
+ {
1027
+ "thumbnail": "http://i.tc-core.com/event/_default/default-thumbnail.jpg",
1028
+ "large": "http://i.tc-core.com/event/_default/default-large.jpg",
1029
+ "mobile": "http://i.tc-core.com/event/_default/default-mobile.jpg"
1030
+ },
886
1031
  "url": "http://thrillcall.com/event/824614"
887
1032
  },
888
1033
  {
@@ -918,6 +1063,7 @@ Returns: _Array_ of Venues _Hash_
918
1063
  "created_at": "2008-04-21T16:52:31Z",
919
1064
  "id": 27418,
920
1065
  "latitude": 37.784796,
1066
+ "long_description": "Description of the venue",
921
1067
  "longitude": -122.418819,
922
1068
  "name": "Great American Music Hall",
923
1069
  "state": "CA",
@@ -925,6 +1071,13 @@ Returns: _Array_ of Venues _Hash_
925
1071
  "updated_at": "2011-01-20T21:04:37Z",
926
1072
  "postalcode": "94109",
927
1073
  "metro_area_id": 105,
1074
+ "photos":
1075
+ {
1076
+ "thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
1077
+ "medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
1078
+ "large": "http://i.tc-core.com/venue/_default/default-large.jpg",
1079
+ "mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
1080
+ }
928
1081
  "url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
929
1082
  },
930
1083
  {