thrillcall-api 0.0.3 → 0.0.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (11) hide show
  1. data/Gemfile.lock +20 -20
  2. data/README.md +163 -10
  3. data/Rakefile +10 -0
  4. data/docs/API.html +172 -11
  5. data/docs/API.md +163 -10
  6. data/docs/README.html +172 -11
  7. data/lib/thrillcall-api/result.rb +1 -1
  8. data/lib/thrillcall-api/version.rb +1 -1
  9. data/spec/thrillcall-api/thrillcall-api_spec.rb +118 -15
  10. data/thrillcall-api.gemspec +6 -6
  11. metadata +32 -32
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
  {