thrillcall-api 0.0.4 → 0.0.6
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/Gemfile.lock +18 -12
- data/README.md +429 -334
- data/docs/API.html +439 -336
- data/docs/API.md +426 -331
- data/docs/README.html +442 -339
- data/docs/WRAPPER.html +3 -3
- data/docs/WRAPPER.md +3 -3
- data/lib/thrillcall-api.rb +9 -3
- data/lib/thrillcall-api/version.rb +1 -1
- data/spec/thrillcall-api/thrillcall-api_spec.rb +116 -8
- data/thrillcall-api.gemspec +3 -1
- metadata +120 -28
data/Gemfile.lock
CHANGED
@@ -1,34 +1,36 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
thrillcall-api (0.0.
|
4
|
+
thrillcall-api (0.0.5)
|
5
5
|
faraday (~> 0.7.0)
|
6
6
|
|
7
7
|
GEM
|
8
8
|
remote: http://rubygems.org/
|
9
9
|
specs:
|
10
10
|
ZenTest (4.6.2)
|
11
|
-
addressable (2.2.
|
11
|
+
addressable (2.2.7)
|
12
12
|
albino (1.3.3)
|
13
13
|
posix-spawn (>= 0.3.6)
|
14
14
|
autotest (4.4.6)
|
15
15
|
ZenTest (>= 4.4.1)
|
16
|
-
autotest-fsevent (0.2.
|
16
|
+
autotest-fsevent (0.2.8)
|
17
17
|
sys-uname
|
18
18
|
autotest-growl (0.2.16)
|
19
|
-
awesome_print (1.0.
|
19
|
+
awesome_print (1.0.2)
|
20
20
|
diff-lcs (1.1.3)
|
21
21
|
faker (0.9.5)
|
22
22
|
i18n (~> 0.4)
|
23
|
-
faraday (0.7.
|
24
|
-
addressable (~> 2.2
|
25
|
-
multipart-post (~> 1.1
|
26
|
-
rack (
|
23
|
+
faraday (0.7.6)
|
24
|
+
addressable (~> 2.2)
|
25
|
+
multipart-post (~> 1.1)
|
26
|
+
rack (~> 1.1)
|
27
|
+
ffi (1.0.11)
|
27
28
|
i18n (0.6.0)
|
28
|
-
multipart-post (1.1.
|
29
|
+
multipart-post (1.1.5)
|
29
30
|
nokogiri (1.4.7)
|
30
31
|
posix-spawn (0.3.6)
|
31
|
-
rack (1.
|
32
|
+
rack (1.4.1)
|
33
|
+
rake (0.9.2.2)
|
32
34
|
redcarpet (1.17.2)
|
33
35
|
rspec (2.7.0)
|
34
36
|
rspec-core (~> 2.7.0)
|
@@ -38,7 +40,9 @@ GEM
|
|
38
40
|
rspec-expectations (2.7.0)
|
39
41
|
diff-lcs (~> 1.1.2)
|
40
42
|
rspec-mocks (2.7.0)
|
41
|
-
sys-uname (0.
|
43
|
+
sys-uname (0.9.0)
|
44
|
+
ffi (>= 1.0.0)
|
45
|
+
tzinfo (0.3.31)
|
42
46
|
|
43
47
|
PLATFORMS
|
44
48
|
ruby
|
@@ -47,12 +51,14 @@ DEPENDENCIES
|
|
47
51
|
ZenTest (~> 4.6.2)
|
48
52
|
albino (~> 1.3.3)
|
49
53
|
autotest (~> 4.4.6)
|
50
|
-
autotest-fsevent (~> 0.2.
|
54
|
+
autotest-fsevent (~> 0.2.8)
|
51
55
|
autotest-growl (~> 0.2.16)
|
52
56
|
awesome_print (~> 1.0.1)
|
53
57
|
bundler (>= 1.0.0)
|
54
58
|
faker (~> 0.9.5)
|
55
59
|
nokogiri (~> 1.4.6)
|
60
|
+
rake (~> 0.9.2.2)
|
56
61
|
redcarpet (~> 1.17.2)
|
57
62
|
rspec (~> 2.7.0)
|
58
63
|
thrillcall-api!
|
64
|
+
tzinfo (~> 0.3.31)
|
data/README.md
CHANGED
@@ -1,5 +1,5 @@
|
|
1
1
|
# Thrillcall API
|
2
|
-
This document describes the Thrillcall API
|
2
|
+
This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.
|
3
3
|
|
4
4
|
# Ruby API Wrapper
|
5
5
|
### Usage:
|
@@ -56,7 +56,7 @@ Provide additional instantiation options:
|
|
56
56
|
|
57
57
|
#---------------------------------------------------------------#
|
58
58
|
# The default SSL endpoint is "https://api.thrillcall.com/api/".
|
59
|
-
# The default API version is
|
59
|
+
# The default API version is 3.
|
60
60
|
# By default, Faraday access logging is turned off.
|
61
61
|
# Override if necessary:
|
62
62
|
#---------------------------------------------------------------#
|
@@ -94,7 +94,7 @@ This gem is a convenience wrapper around the excellent Faraday project. If more
|
|
94
94
|
require 'json'
|
95
95
|
|
96
96
|
MY_API_KEY = "1234567890abcdef"
|
97
|
-
BASE_URL = "https://api.thrillcall.com/api/
|
97
|
+
BASE_URL = "https://api.thrillcall.com/api/v3/"
|
98
98
|
HEADERS = { :accept => 'application/json' }
|
99
99
|
|
100
100
|
connection = Faraday.new( :url => BASE_URL, :headers => HEADERS ) do |builder|
|
@@ -134,7 +134,7 @@ These are valid parameters for any endpoint, however, they will only be used by
|
|
134
134
|
|
135
135
|
_Default: 100_
|
136
136
|
|
137
|
-
Sets the maximum number of results to return. Cannot be above
|
137
|
+
Sets the maximum number of results to return. Cannot be above 200.
|
138
138
|
|
139
139
|
- <a name="page" />**page** _integer_
|
140
140
|
|
@@ -144,6 +144,13 @@ These are valid parameters for any endpoint, however, they will only be used by
|
|
144
144
|
|
145
145
|
Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29
|
146
146
|
|
147
|
+
- <a name="time_zone" />**time\_zone** _string (format: TZ Database string, eg "America/Los\_Angeles")_
|
148
|
+
|
149
|
+
_Default: UTC_
|
150
|
+
_For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden._
|
151
|
+
|
152
|
+
**[min\_date](#min_date)** and **[max\_date](#max_date)** will be calculated based on this time zone.
|
153
|
+
|
147
154
|
- <a name="min_date" />**min\_date** _string (format: "YYYY-MM-DD")_
|
148
155
|
|
149
156
|
_Default: Today_
|
@@ -156,6 +163,18 @@ These are valid parameters for any endpoint, however, they will only be used by
|
|
156
163
|
|
157
164
|
Results after this date will not be returned.
|
158
165
|
|
166
|
+
- <a name="min_updated_at" />**min\_updated\_at** _string (format: "YYYY-MM-DD")_
|
167
|
+
|
168
|
+
_Default: none_
|
169
|
+
|
170
|
+
Results with updated_at columns before this date will not be returned.
|
171
|
+
|
172
|
+
- <a name="max_date" />**max\_updated\_at** _string (format: "YYYY-MM-DD")_
|
173
|
+
|
174
|
+
_Default: none_
|
175
|
+
|
176
|
+
Results with updated_at columns after this date will not be returned.
|
177
|
+
|
159
178
|
- <a name="lat" />**lat** _float_
|
160
179
|
|
161
180
|
_Default: none_
|
@@ -205,6 +224,12 @@ These are valid parameters for any endpoint, however, they will only be used by
|
|
205
224
|
|
206
225
|
If set to _true_ or _1_, will only return results that have tickets associated with them.
|
207
226
|
|
227
|
+
- <a name="show_disabled_events" />**show\_disabled\_events** _boolean_
|
228
|
+
|
229
|
+
_Default: false_
|
230
|
+
|
231
|
+
If set to _true_ or _1_, will not filter out events which have been disabled internally.
|
232
|
+
|
208
233
|
- <a name="show_unconfirmed_events" />**show\_unconfirmed\_events** _boolean_
|
209
234
|
|
210
235
|
_Default: false_
|
@@ -261,7 +286,7 @@ These are valid parameters for any endpoint, however, they will only be used by
|
|
261
286
|
|
262
287
|
- <a name="referral_code" />**referral\_code** _string_
|
263
288
|
|
264
|
-
The referral code to be used during registration. Both the owner of the code as well as the new user will receive a
|
289
|
+
The referral code to be used during registration. Both the owner of the code as well as the new user will receive a referral credit point.
|
265
290
|
|
266
291
|
|
267
292
|
## Artists
|
@@ -288,7 +313,7 @@ Params:
|
|
288
313
|
Returns: _Array_ of Artists _Hash_
|
289
314
|
|
290
315
|
``` js
|
291
|
-
// Example: GET /api/
|
316
|
+
// Example: GET /api/v3/artists?limit=14&api_key=1234567890abcdef
|
292
317
|
|
293
318
|
[
|
294
319
|
{
|
@@ -299,13 +324,12 @@ Returns: _Array_ of Artists _Hash_
|
|
299
324
|
"primary_genre_id": 61,
|
300
325
|
"upcoming_events_count": 0,
|
301
326
|
"updated_at": "2010-03-26T16:49:20Z",
|
302
|
-
"photos":
|
303
|
-
|
304
|
-
|
305
|
-
|
306
|
-
|
307
|
-
|
308
|
-
},
|
327
|
+
"photos": {
|
328
|
+
"thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
|
329
|
+
"medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
|
330
|
+
"large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
|
331
|
+
"mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
|
332
|
+
},
|
309
333
|
"url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
|
310
334
|
},
|
311
335
|
{
|
@@ -325,24 +349,23 @@ Params:
|
|
325
349
|
Returns: Artist _Hash_
|
326
350
|
|
327
351
|
``` js
|
328
|
-
// Example: GET /api/
|
352
|
+
// Example: GET /api/v3/artist/378465?api_key=1234567890abcdef
|
329
353
|
|
330
354
|
{
|
331
|
-
"created_at": "
|
332
|
-
"genre_tags": "
|
333
|
-
"id":
|
334
|
-
"name": "
|
335
|
-
"primary_genre_id":
|
336
|
-
"upcoming_events_count":
|
337
|
-
"updated_at": "
|
338
|
-
"photos":
|
339
|
-
|
340
|
-
|
341
|
-
|
342
|
-
|
343
|
-
|
344
|
-
|
345
|
-
"url": "http://thrillcall.com/artist/The_Sea_and_Cake"
|
355
|
+
"created_at": "2011-05-19T20:27:47Z",
|
356
|
+
"genre_tags": "Operatic pop",
|
357
|
+
"id": 378465,
|
358
|
+
"name": "Il Volo",
|
359
|
+
"primary_genre_id": 61,
|
360
|
+
"upcoming_events_count": 30,
|
361
|
+
"updated_at": "2012-03-27T15:59:04Z",
|
362
|
+
"photos": {
|
363
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
364
|
+
"medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
|
365
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
366
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
367
|
+
},
|
368
|
+
"url": "http://thrillcall.com/artist/Il_Volo"
|
346
369
|
}
|
347
370
|
```
|
348
371
|
|
@@ -353,8 +376,11 @@ Params:
|
|
353
376
|
|
354
377
|
- **[limit](#limit)**
|
355
378
|
- **[page](#page)**
|
379
|
+
- **[time\_zone](#time_zone)**
|
356
380
|
- **[min\_date](#min_date)**
|
357
381
|
- **[max\_date](#max_date)**
|
382
|
+
- **[min\_updated\_at](#min_updated_at)**
|
383
|
+
- **[max\_updated\_at](#max_updated_at)**
|
358
384
|
- **[lat](#lat)**
|
359
385
|
- **[long](#long)**
|
360
386
|
- **[postalcode](#postalcode)**
|
@@ -362,40 +388,40 @@ Params:
|
|
362
388
|
- **[use\_partner\_id](#use_partner_id)**
|
363
389
|
- **[ticket\_type](#ticket_type)**
|
364
390
|
- **[must\_have\_tickets](#must_have_tickets)**
|
391
|
+
- **[show\_disabled\_events](#show_disabled_events)**
|
365
392
|
- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
|
366
393
|
- **[show\_rumor\_events](#show_rumor_events)**
|
367
394
|
|
368
395
|
Returns: _Array_ of Events _Hash_
|
369
396
|
|
370
397
|
``` js
|
371
|
-
// Example: GET /api/
|
398
|
+
// Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef
|
372
399
|
|
373
400
|
[
|
374
401
|
{
|
375
|
-
"created_at": "
|
376
|
-
"end_date": null,
|
402
|
+
"created_at": "2012-03-02T08:01:03Z",
|
377
403
|
"festival": false,
|
378
|
-
"id":
|
379
|
-
"latitude":
|
380
|
-
"longitude": -
|
381
|
-
"name": "
|
382
|
-
"num_cancelled_bookings": 0,
|
383
|
-
"num_confirmed_bookings": 1,
|
384
|
-
"num_disabled_bookings": 0,
|
385
|
-
"num_unconfirmed_bookings": 0,
|
404
|
+
"id": 1046915,
|
405
|
+
"latitude": 47.6136,
|
406
|
+
"longitude": -122.332,
|
407
|
+
"name": "Il Volo @ Paramount Theatre - Seattle",
|
386
408
|
"on_sale_date": null,
|
387
409
|
"rumor": false,
|
388
|
-
"start_date": "
|
410
|
+
"start_date": "2012-10-02T19:30:00Z",
|
411
|
+
"starts_at": "2012-10-03T02:30:00Z",
|
412
|
+
"starts_at_time_trusted": true,
|
389
413
|
"unconfirmed_location": 0,
|
390
|
-
"updated_at": "
|
391
|
-
"venue_id":
|
392
|
-
"photos":
|
393
|
-
|
394
|
-
|
395
|
-
|
396
|
-
|
397
|
-
|
398
|
-
"
|
414
|
+
"updated_at": "2012-03-29T01:35:53Z",
|
415
|
+
"venue_id": 61705,
|
416
|
+
"photos": {
|
417
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
418
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
419
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
420
|
+
},
|
421
|
+
"url": "http://thrillcall.com/event/1046915",
|
422
|
+
"starts_at_local": "2012-10-02T19:30:00-07:00",
|
423
|
+
"time_zone": "America/Los_Angeles",
|
424
|
+
"status": "confirmed"
|
399
425
|
},
|
400
426
|
{
|
401
427
|
...
|
@@ -415,25 +441,24 @@ Params:
|
|
415
441
|
Returns: _Array_ of Artists _Hash_
|
416
442
|
|
417
443
|
``` js
|
418
|
-
// Example: GET /api/
|
444
|
+
// Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef
|
419
445
|
|
420
446
|
[
|
421
447
|
{
|
422
|
-
"created_at": "
|
423
|
-
"genre_tags": "
|
424
|
-
"id":
|
425
|
-
"name": "
|
426
|
-
"primary_genre_id":
|
427
|
-
"upcoming_events_count":
|
428
|
-
"updated_at": "
|
429
|
-
"photos":
|
430
|
-
|
431
|
-
|
432
|
-
|
433
|
-
|
434
|
-
|
435
|
-
|
436
|
-
"url": "http://thrillcall.com/artist/The_Sea_and_Cake"
|
448
|
+
"created_at": "2011-05-19T20:27:47Z",
|
449
|
+
"genre_tags": "Operatic pop",
|
450
|
+
"id": 378465,
|
451
|
+
"name": "Il Volo",
|
452
|
+
"primary_genre_id": 61,
|
453
|
+
"upcoming_events_count": 30,
|
454
|
+
"updated_at": "2012-03-27T15:59:04Z",
|
455
|
+
"photos": {
|
456
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
457
|
+
"medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
|
458
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
459
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
460
|
+
},
|
461
|
+
"url": "http://thrillcall.com/artist/Il_Volo"
|
437
462
|
},
|
438
463
|
{
|
439
464
|
...
|
@@ -446,20 +471,19 @@ Returns: _Array_ of Artists _Hash_
|
|
446
471
|
Fields:
|
447
472
|
|
448
473
|
- **created\_at** _string_ ISO 8601 representation the time this object was created
|
449
|
-
- **end\_date** _string_ ISO 8601 representation of the end of the Event
|
450
474
|
- **festival** _boolean_ Is this event a festival?
|
451
475
|
- **id** _integer_ Thrillcall ID
|
452
476
|
- **latitude** _float_ Approximate latitude for the Event
|
453
477
|
- **longitude** _float_ Approximate longitude for the Event
|
454
478
|
- **name** _string_ Name of the Event
|
455
|
-
- **num\_confirmed\_bookings** _integer_ The number of confirmed Artist bookings for this event. Only Artists with a confirmed booking are returned when requesting artists for an event.
|
456
|
-
- **num\_unconfirmed\_bookings** _integer_ The number of unconfirmed Artist bookings for this event
|
457
|
-
- **num\_disabled\_bookings** _integer_ The number of disabled Artist bookings for this event
|
458
|
-
- **num\_cancelled\_bookings** _integer_ The number of cancelled Artist bookings for this event
|
459
479
|
- **on\_sale\_date** _string_ ISO 8601 representation of the date when tickets go on sale
|
460
480
|
- **rumor** _boolean_ Are the details for this event based on a rumor?
|
461
|
-
- **
|
462
|
-
- **
|
481
|
+
- **status** _string_ Status of the event (confirmed, unconfirmed, cancelled, or disabled)
|
482
|
+
- **starts\_at** _string_ ISO 8601 representation of the start of the Event in UTC time
|
483
|
+
- **starts\_at\_local** _string_ ISO 8601 representation of the start of the Event in the local timezone
|
484
|
+
- **starts\_at\_time\_trusted** _boolean_ Do we trust that the time of day component of **starts\_at** is valid?
|
485
|
+
- **time\_zone** _string_ TZ Database string representing the time zone at the location of the event
|
486
|
+
- **unconfirmed\_location** _integer_ If 1, the location of this event is unconfirmed
|
463
487
|
- **updated\_at** _string_ ISO 8601 representation of last time this object was updated
|
464
488
|
- **venue\_id** _integer_ Thrillcall Venue ID
|
465
489
|
- **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
|
@@ -471,48 +495,51 @@ Params:
|
|
471
495
|
|
472
496
|
- **[limit](#limit)**
|
473
497
|
- **[page](#page)**
|
498
|
+
- **[time\_zone](#time_zone)**
|
474
499
|
- **[min\_date](#min_date)**
|
475
500
|
- **[max\_date](#max_date)**
|
501
|
+
- **[min\_updated\_at](#min_updated_at)**
|
502
|
+
- **[max\_updated\_at](#max_updated_at)**
|
476
503
|
- **[lat](#lat)**
|
477
504
|
- **[long](#long)**
|
478
505
|
- **[postalcode](#postalcode)**
|
479
506
|
- **[radius](#radius)**
|
480
507
|
- **[ticket\_type](#ticket_type)**
|
481
508
|
- **[must\_have\_tickets](#must_have_tickets)**
|
509
|
+
- **[show\_disabled\_events](#show_disabled_events)**
|
482
510
|
- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
|
483
511
|
- **[show\_rumor\_events](#show_rumor_events)**
|
484
512
|
|
485
513
|
Returns: _Array_ of Events _Hash_
|
486
514
|
|
487
515
|
``` js
|
488
|
-
// Example: GET /api/
|
516
|
+
// Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef
|
489
517
|
|
490
518
|
[
|
491
519
|
{
|
492
|
-
"created_at": "
|
493
|
-
"end_date": null,
|
520
|
+
"created_at": "2012-03-02T18:06:14Z",
|
494
521
|
"festival": false,
|
495
|
-
"id":
|
496
|
-
"latitude": 37.
|
497
|
-
"longitude": -122.
|
498
|
-
"name": "
|
499
|
-
"num_cancelled_bookings": 0,
|
500
|
-
"num_confirmed_bookings": 1,
|
501
|
-
"num_disabled_bookings": 0,
|
502
|
-
"num_unconfirmed_bookings": 0,
|
522
|
+
"id": 1047075,
|
523
|
+
"latitude": 37.7915,
|
524
|
+
"longitude": -122.413,
|
525
|
+
"name": "Il Volo @ Masonic Center",
|
503
526
|
"on_sale_date": null,
|
504
527
|
"rumor": false,
|
505
|
-
"start_date": "
|
528
|
+
"start_date": "2012-09-29T19:30:04Z",
|
529
|
+
"starts_at": "2012-09-30T02:30:04Z",
|
530
|
+
"starts_at_time_trusted": true,
|
506
531
|
"unconfirmed_location": 0,
|
507
|
-
"updated_at": "
|
508
|
-
"venue_id":
|
509
|
-
"photos":
|
510
|
-
|
511
|
-
|
512
|
-
|
513
|
-
|
514
|
-
|
515
|
-
"
|
532
|
+
"updated_at": "2012-03-29T01:35:57Z",
|
533
|
+
"venue_id": 63279,
|
534
|
+
"photos": {
|
535
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
536
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
537
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
538
|
+
},
|
539
|
+
"url": "http://thrillcall.com/event/1047075",
|
540
|
+
"starts_at_local": "2012-09-29T19:30:04-07:00",
|
541
|
+
"time_zone": "America/Los_Angeles"
|
542
|
+
"status": "confirmed"
|
516
543
|
},
|
517
544
|
{
|
518
545
|
...
|
@@ -531,33 +558,33 @@ Params:
|
|
531
558
|
Returns: Event _Hash_
|
532
559
|
|
533
560
|
``` js
|
534
|
-
// Example: GET /api/
|
561
|
+
// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
|
535
562
|
|
536
563
|
{
|
537
|
-
"
|
538
|
-
"
|
539
|
-
"
|
540
|
-
"
|
541
|
-
"
|
542
|
-
"
|
543
|
-
"
|
544
|
-
"
|
545
|
-
"
|
546
|
-
"
|
547
|
-
"
|
548
|
-
"
|
549
|
-
"
|
550
|
-
"
|
551
|
-
"
|
552
|
-
"
|
553
|
-
"
|
554
|
-
|
555
|
-
|
556
|
-
|
557
|
-
|
558
|
-
|
559
|
-
|
560
|
-
"url": "http://thrillcall.com/
|
564
|
+
"address1": "1111 California Street",
|
565
|
+
"address2": null,
|
566
|
+
"city": "San Francisco",
|
567
|
+
"country": "US",
|
568
|
+
"created_at": "2009-08-25T19:25:27Z",
|
569
|
+
"id": 63279,
|
570
|
+
"latitude": 37.79153,
|
571
|
+
"long_description": null,
|
572
|
+
"longitude": -122.412757,
|
573
|
+
"name": "Masonic Center",
|
574
|
+
"phone_number": null,
|
575
|
+
"state": "CA",
|
576
|
+
"time_zone": "America/Los_Angeles",
|
577
|
+
"upcoming_events_count": 4,
|
578
|
+
"updated_at": "2012-04-04T02:08:50Z",
|
579
|
+
"postalcode": "94108",
|
580
|
+
"photos": {
|
581
|
+
"thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
|
582
|
+
"medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
|
583
|
+
"large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
|
584
|
+
"mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
|
585
|
+
},
|
586
|
+
"metro_area_id": 105,
|
587
|
+
"url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
|
561
588
|
}
|
562
589
|
```
|
563
590
|
|
@@ -572,25 +599,24 @@ Params:
|
|
572
599
|
Returns: _Array_ of Artists _Hash_
|
573
600
|
|
574
601
|
``` js
|
575
|
-
// Example: GET /api/
|
602
|
+
// Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef
|
576
603
|
|
577
604
|
[
|
578
605
|
{
|
579
|
-
"created_at": "
|
580
|
-
"genre_tags": "
|
581
|
-
"id":
|
582
|
-
"name": "
|
583
|
-
"primary_genre_id":
|
584
|
-
"upcoming_events_count":
|
585
|
-
"updated_at": "
|
586
|
-
"photos":
|
587
|
-
|
588
|
-
|
589
|
-
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
"url": "http://thrillcall.com/artist/The_Sea_and_Cake"
|
606
|
+
"created_at": "2011-05-19T20:27:47Z",
|
607
|
+
"genre_tags": "Operatic pop",
|
608
|
+
"id": 378465,
|
609
|
+
"name": "Il Volo",
|
610
|
+
"primary_genre_id": 61,
|
611
|
+
"upcoming_events_count": 30,
|
612
|
+
"updated_at": "2012-03-27T15:59:04Z",
|
613
|
+
"photos": {
|
614
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
615
|
+
"medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
|
616
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
617
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
618
|
+
},
|
619
|
+
"url": "http://thrillcall.com/artist/Il_Volo"
|
594
620
|
},
|
595
621
|
{
|
596
622
|
...
|
@@ -609,31 +635,33 @@ Params:
|
|
609
635
|
Returns: Venue _Hash_
|
610
636
|
|
611
637
|
``` js
|
612
|
-
// Example: GET /api/
|
638
|
+
// Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef
|
613
639
|
|
614
640
|
{
|
615
|
-
"address1": "
|
641
|
+
"address1": "1111 California Street",
|
616
642
|
"address2": null,
|
617
643
|
"city": "San Francisco",
|
618
644
|
"country": "US",
|
619
|
-
"created_at": "
|
620
|
-
"id":
|
621
|
-
"latitude": 37.
|
622
|
-
"
|
623
|
-
"
|
645
|
+
"created_at": "2009-08-25T19:25:27Z",
|
646
|
+
"id": 63279,
|
647
|
+
"latitude": 37.79153,
|
648
|
+
"long_description": null,
|
649
|
+
"longitude": -122.412757,
|
650
|
+
"name": "Masonic Center",
|
651
|
+
"phone_number": null,
|
624
652
|
"state": "CA",
|
625
|
-
"
|
626
|
-
"
|
627
|
-
"
|
653
|
+
"time_zone": "America/Los_Angeles",
|
654
|
+
"upcoming_events_count": 4,
|
655
|
+
"updated_at": "2012-04-04T02:08:50Z",
|
656
|
+
"postalcode": "94108",
|
657
|
+
"photos": {
|
658
|
+
"thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
|
659
|
+
"medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
|
660
|
+
"large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
|
661
|
+
"mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
|
662
|
+
},
|
628
663
|
"metro_area_id": 105,
|
629
|
-
"
|
630
|
-
{
|
631
|
-
"thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
|
632
|
-
"medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
|
633
|
-
"large": "http://i.tc-core.com/venue/_default/default-large.jpg",
|
634
|
-
"mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
|
635
|
-
}
|
636
|
-
"url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
|
664
|
+
"url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
|
637
665
|
}
|
638
666
|
```
|
639
667
|
|
@@ -649,23 +677,23 @@ Params:
|
|
649
677
|
Returns: _Array_ of Tickets _Hash_
|
650
678
|
|
651
679
|
``` js
|
652
|
-
// Example: GET /api/
|
680
|
+
// Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef
|
653
681
|
|
654
682
|
[
|
655
683
|
{
|
656
|
-
"created_at": "
|
684
|
+
"created_at": "2012-03-02T18:06:14Z",
|
657
685
|
"description": null,
|
658
|
-
"event_id":
|
659
|
-
"id":
|
686
|
+
"event_id": 1047075,
|
687
|
+
"id": 819883,
|
660
688
|
"marketing_text": null,
|
661
|
-
"max_ticket_price":
|
662
|
-
"min_ticket_price":
|
663
|
-
"name": "
|
689
|
+
"max_ticket_price": 85,
|
690
|
+
"min_ticket_price": 29,
|
691
|
+
"name": "Onsale to General Public",
|
664
692
|
"on_sale_end_date": null,
|
665
693
|
"on_sale_start_date": null,
|
666
694
|
"seat_info": null,
|
667
|
-
"updated_at": "
|
668
|
-
"url": "http://
|
695
|
+
"updated_at": "2012-03-02T18:06:14Z",
|
696
|
+
"url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
|
669
697
|
},
|
670
698
|
{
|
671
699
|
...
|
@@ -692,7 +720,7 @@ Params:
|
|
692
720
|
Returns: _Array_ of Genres _Hash_
|
693
721
|
|
694
722
|
``` js
|
695
|
-
// Example: GET /api/
|
723
|
+
// Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef
|
696
724
|
|
697
725
|
[
|
698
726
|
{
|
@@ -719,7 +747,7 @@ Params:
|
|
719
747
|
Returns: Genre _Hash_
|
720
748
|
|
721
749
|
``` js
|
722
|
-
// Example: GET /api/
|
750
|
+
// Example: GET /api/v3/genre/27?api_key=1234567890abcdef
|
723
751
|
|
724
752
|
{
|
725
753
|
"created_at": "2008-07-09T19:17:45Z",
|
@@ -741,25 +769,24 @@ Params:
|
|
741
769
|
Returns: _Array_ of Artists _Hash_
|
742
770
|
|
743
771
|
``` js
|
744
|
-
// Example: GET /api/
|
772
|
+
// Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef
|
745
773
|
|
746
774
|
[
|
747
775
|
{
|
748
|
-
"created_at": "2008-04-29T10:
|
749
|
-
"genre_tags": "
|
750
|
-
"id":
|
751
|
-
"name": "
|
752
|
-
"primary_genre_id":
|
753
|
-
"upcoming_events_count":
|
754
|
-
"updated_at": "
|
755
|
-
"photos":
|
756
|
-
|
757
|
-
|
758
|
-
|
759
|
-
|
760
|
-
|
761
|
-
|
762
|
-
"url": "http://thrillcall.com/artist/Espers"
|
776
|
+
"created_at": "2008-04-29T10:19:45Z",
|
777
|
+
"genre_tags": "O",
|
778
|
+
"id": 1,
|
779
|
+
"name": "Hyler Jones Proteges",
|
780
|
+
"primary_genre_id": 61,
|
781
|
+
"upcoming_events_count": 0,
|
782
|
+
"updated_at": "2010-03-26T16:49:20Z",
|
783
|
+
"photos": {
|
784
|
+
"thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
|
785
|
+
"medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
|
786
|
+
"large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
|
787
|
+
"mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
|
788
|
+
},
|
789
|
+
"url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
|
763
790
|
},
|
764
791
|
{
|
765
792
|
...
|
@@ -771,17 +798,18 @@ Returns: _Array_ of Artists _Hash_
|
|
771
798
|
## Metro Area
|
772
799
|
Fields:
|
773
800
|
|
774
|
-
- **city**
|
775
|
-
- **country**
|
776
|
-
- **created\_at**
|
777
|
-
- **id**
|
778
|
-
- **latitude**
|
779
|
-
- **longitude**
|
780
|
-
- **radius**
|
781
|
-
- **state**
|
782
|
-
- **time\_zone**
|
783
|
-
- **updated\_at**
|
784
|
-
- **url**
|
801
|
+
- **city** _string_ City of the Metro Area
|
802
|
+
- **country** _string_ Country of the Metro Area
|
803
|
+
- **created\_at** _string_ ISO 8601 representation the time this object was created
|
804
|
+
- **id** _integer_ Thrillcall ID
|
805
|
+
- **latitude** _float_ Latitude of the Metro Area
|
806
|
+
- **longitude** _float_ Longitude of the Metro Area
|
807
|
+
- **radius** _integer_ Radius of the Metro Area from the Lat/Long center
|
808
|
+
- **state** _string_ State of the Metro Area
|
809
|
+
- **time\_zone** _string_ Time zone of the Metro Area
|
810
|
+
- **updated\_at** _string_ ISO 8601 representation of last time this object was updated
|
811
|
+
- **url** _string_ URL for this object on Thrillcall
|
812
|
+
- **offers\_availability\_status\_code** _integer_ Offers status for the Metro Area ( no\_offers = 0, available = 1, coming\_soon = 2)
|
785
813
|
|
786
814
|
### GET /metro_areas
|
787
815
|
Params:
|
@@ -792,7 +820,7 @@ Params:
|
|
792
820
|
Returns: _Array_ of Metro Areas _Hash_
|
793
821
|
|
794
822
|
``` js
|
795
|
-
// Example: GET /api/
|
823
|
+
// Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef
|
796
824
|
|
797
825
|
[
|
798
826
|
{
|
@@ -802,10 +830,11 @@ Returns: _Array_ of Metro Areas _Hash_
|
|
802
830
|
"id": 104,
|
803
831
|
"latitude": 41.8842,
|
804
832
|
"longitude": -87.6324,
|
833
|
+
"offers_availability_status_code": 1,
|
805
834
|
"radius": 50,
|
806
835
|
"state": "IL",
|
807
836
|
"time_zone": "America/Chicago",
|
808
|
-
"updated_at": "2011-
|
837
|
+
"updated_at": "2011-12-27T00:44:37Z",
|
809
838
|
"url": "http://thrillcall.com/live-music/chicago"
|
810
839
|
},
|
811
840
|
{
|
@@ -825,7 +854,7 @@ Params:
|
|
825
854
|
Returns: Metro Area _Hash_
|
826
855
|
|
827
856
|
``` js
|
828
|
-
// Example: GET /api/
|
857
|
+
// Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef
|
829
858
|
|
830
859
|
{
|
831
860
|
"city": "San Francisco",
|
@@ -834,10 +863,11 @@ Returns: Metro Area _Hash_
|
|
834
863
|
"id": 105,
|
835
864
|
"latitude": 37.7771,
|
836
865
|
"longitude": -122.42,
|
866
|
+
"offers_availability_status_code": 1,
|
837
867
|
"radius": 50,
|
838
868
|
"state": "CA",
|
839
|
-
"time_zone": "America/
|
840
|
-
"updated_at": "2011-
|
869
|
+
"time_zone": "America/Los_Angeles",
|
870
|
+
"updated_at": "2011-12-27T00:44:37Z",
|
841
871
|
"url": "http://thrillcall.com/live-music/san-francisco"
|
842
872
|
}
|
843
873
|
```
|
@@ -851,43 +881,47 @@ Params:
|
|
851
881
|
- **[page](#page)**
|
852
882
|
- **[min\_date](#min_date)**
|
853
883
|
- **[max\_date](#max_date)**
|
884
|
+
- **[min\_updated\_at](#min_updated_at)**
|
885
|
+
- **[max\_updated\_at](#max_updated_at)**
|
854
886
|
- **[radius](#radius)**
|
855
887
|
- **[ticket\_type](#ticket_type)**
|
856
888
|
- **[must\_have\_tickets](#must_have_tickets)**
|
889
|
+
- **[show\_disabled\_events](#show_disabled_events)**
|
857
890
|
- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
|
858
891
|
- **[show\_rumor\_events](#show_rumor_events)**
|
859
892
|
|
893
|
+
Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.
|
894
|
+
|
860
895
|
Returns: _Array_ of Metro Areas _Hash_
|
861
896
|
|
862
897
|
``` js
|
863
|
-
// Example: GET /api/
|
898
|
+
// Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&max_date=2012-04-04&limit=3&api_key=1234567890abcdef
|
864
899
|
|
865
900
|
[
|
866
901
|
{
|
867
|
-
"created_at": "
|
868
|
-
"end_date": null,
|
902
|
+
"created_at": "2012-01-02T08:53:00Z",
|
869
903
|
"festival": false,
|
870
|
-
"id":
|
871
|
-
"latitude": 37.
|
872
|
-
"longitude": -122.
|
873
|
-
"name": "
|
874
|
-
"num_cancelled_bookings": 0,
|
875
|
-
"num_confirmed_bookings": 1,
|
876
|
-
"num_disabled_bookings": 0,
|
877
|
-
"num_unconfirmed_bookings": 0,
|
904
|
+
"id": 1011386,
|
905
|
+
"latitude": 37.7771,
|
906
|
+
"longitude": -122.42,
|
907
|
+
"name": "Kontrol @ The End Up",
|
878
908
|
"on_sale_date": null,
|
879
909
|
"rumor": false,
|
880
|
-
"start_date": "2012-
|
910
|
+
"start_date": "2012-01-07T00:00:04Z",
|
911
|
+
"starts_at": "2012-01-07T08:00:04Z",
|
912
|
+
"starts_at_time_trusted": false,
|
881
913
|
"unconfirmed_location": 0,
|
882
|
-
"updated_at": "
|
883
|
-
"venue_id":
|
884
|
-
"photos":
|
885
|
-
|
886
|
-
|
887
|
-
|
888
|
-
|
889
|
-
|
890
|
-
"
|
914
|
+
"updated_at": "2012-03-29T01:19:31Z",
|
915
|
+
"venue_id": 47273,
|
916
|
+
"photos": {
|
917
|
+
"thumbnail": "http://i.development.tc-core.com/event/_default/default-thumbnail.jpg",
|
918
|
+
"large": "http://i.development.tc-core.com/event/_default/default-large.jpg",
|
919
|
+
"mobile": "http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
|
920
|
+
},
|
921
|
+
"url": "http://thrillcall.com/event/1011386",
|
922
|
+
"starts_at_local": "2012-01-07T00:00:04-08:00",
|
923
|
+
"time_zone": "America/Los_Angeles"
|
924
|
+
"status": "confirmed"
|
891
925
|
},
|
892
926
|
{
|
893
927
|
...
|
@@ -909,10 +943,46 @@ Fields:
|
|
909
943
|
- **login** _string_ Login (Email Address) of the Person
|
910
944
|
- **updated\_at** _string_ ISO 8601 representation of last time this object was updated
|
911
945
|
- **referral\_code** _string_ Referral code of the Person
|
912
|
-
- **referral\
|
946
|
+
- **referral\_credits** _integer_ Number of Referral credits the Person has (including bonus points)
|
913
947
|
- **postalcode** _string_ Postalcode of the Person
|
914
948
|
- **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
|
915
949
|
|
950
|
+
### GET /person/:id
|
951
|
+
Params:
|
952
|
+
|
953
|
+
- None.
|
954
|
+
|
955
|
+
Returns: Person _Hash_
|
956
|
+
|
957
|
+
``` js
|
958
|
+
// Example: GET /api/v3/person/49?api_key=1234567890abcdef
|
959
|
+
|
960
|
+
{
|
961
|
+
"address1": null,
|
962
|
+
"address2": null,
|
963
|
+
"city": "Santa Rosa",
|
964
|
+
"country_code": "US",
|
965
|
+
"created_at": "2011-10-17T18:54:31Z",
|
966
|
+
"first_name": "John",
|
967
|
+
"gender": "m",
|
968
|
+
"id": 49,
|
969
|
+
"last_name": "Doe",
|
970
|
+
"login": "bogus@bogus.com",
|
971
|
+
"state": "CA",
|
972
|
+
"time_zone": "America/Los_Angeles",
|
973
|
+
"timezone": "-7",
|
974
|
+
"updated_at": "2012-03-28T16:07:16Z",
|
975
|
+
"referral_code": null,
|
976
|
+
"referral_credits": 0,
|
977
|
+
"postalcode": "95407",
|
978
|
+
"photos": {
|
979
|
+
"small_thumb": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
|
980
|
+
"thumbnail": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
|
981
|
+
"medium": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"
|
982
|
+
}
|
983
|
+
}
|
984
|
+
```
|
985
|
+
|
916
986
|
### POST /person/signin
|
917
987
|
Params:
|
918
988
|
|
@@ -935,25 +1005,30 @@ May perform registration ("signup") automatically if using **[provider](#provide
|
|
935
1005
|
Returns: Person _Hash_
|
936
1006
|
|
937
1007
|
``` js
|
938
|
-
// Example: POST /api/
|
1008
|
+
// Example: POST /api/v3/person/signin?provider=facebook&uid=123123bogus&token=123123bogus&email=123123bogus%40bogus.com&first_name=Mister&last_name=Bogus&lat=38.5&long=-123.0&api_key=1234567890abcdef
|
939
1009
|
|
940
1010
|
{
|
941
|
-
"
|
942
|
-
"
|
1011
|
+
"address1": null,
|
1012
|
+
"address2": null,
|
1013
|
+
"city": null,
|
1014
|
+
"country_code": null,
|
1015
|
+
"created_at": null,
|
1016
|
+
"first_name": "Mister",
|
943
1017
|
"gender": null,
|
944
|
-
"
|
945
|
-
"
|
946
|
-
"
|
947
|
-
"
|
948
|
-
"
|
949
|
-
"
|
950
|
-
"
|
951
|
-
|
952
|
-
|
953
|
-
|
954
|
-
|
955
|
-
|
956
|
-
|
1018
|
+
"last_name": "Bogus",
|
1019
|
+
"login": null,
|
1020
|
+
"state": null,
|
1021
|
+
"time_zone": null,
|
1022
|
+
"timezone": null,
|
1023
|
+
"updated_at": null,
|
1024
|
+
"referral_code": null,
|
1025
|
+
"referral_credits": 0,
|
1026
|
+
"postalcode": null,
|
1027
|
+
"photos": {
|
1028
|
+
"small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
|
1029
|
+
"thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
|
1030
|
+
"medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
|
1031
|
+
}
|
957
1032
|
}
|
958
1033
|
```
|
959
1034
|
|
@@ -971,26 +1046,31 @@ Params:
|
|
971
1046
|
Returns: Person _Hash_
|
972
1047
|
|
973
1048
|
``` js
|
974
|
-
// Example: POST /api/
|
1049
|
+
// Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef
|
975
1050
|
|
976
1051
|
{
|
977
|
-
|
978
|
-
|
979
|
-
|
980
|
-
|
981
|
-
|
982
|
-
|
983
|
-
|
984
|
-
|
985
|
-
|
986
|
-
|
987
|
-
|
988
|
-
|
989
|
-
|
990
|
-
|
991
|
-
|
992
|
-
|
993
|
-
|
1052
|
+
"address1": null,
|
1053
|
+
"address2": null,
|
1054
|
+
"city": null,
|
1055
|
+
"country_code": null,
|
1056
|
+
"created_at": null,
|
1057
|
+
"first_name": "Mister",
|
1058
|
+
"gender": null,
|
1059
|
+
"last_name": null,
|
1060
|
+
"login": null,
|
1061
|
+
"state": null,
|
1062
|
+
"time_zone": null,
|
1063
|
+
"timezone": null,
|
1064
|
+
"updated_at": null,
|
1065
|
+
"referral_code": null,
|
1066
|
+
"referral_credits": 0,
|
1067
|
+
"postalcode": null,
|
1068
|
+
"photos": {
|
1069
|
+
"small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
|
1070
|
+
"thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
|
1071
|
+
"medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
|
1072
|
+
}
|
1073
|
+
}
|
994
1074
|
```
|
995
1075
|
|
996
1076
|
|
@@ -1012,6 +1092,7 @@ Fields:
|
|
1012
1092
|
- **upcoming\_events\_count** _integer_ Number of upcoming events associated with this object
|
1013
1093
|
- **updated\_at** _string_ ISO 8601 representation of last time this object was updated
|
1014
1094
|
- **postalcode** _string_ Postal code for the Venue
|
1095
|
+
- **phone\_number** _string_ Phone number for the Venue (including country code)
|
1015
1096
|
- **photos** _hash_ A hash of image urls of the primary photo available for this object in different styles
|
1016
1097
|
- **url** _string_ URL for this object on Thrillcall
|
1017
1098
|
|
@@ -1029,7 +1110,7 @@ Params:
|
|
1029
1110
|
Returns: _Array_ of Venues _Hash_
|
1030
1111
|
|
1031
1112
|
``` js
|
1032
|
-
// Example: GET /api/
|
1113
|
+
// Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef
|
1033
1114
|
|
1034
1115
|
[
|
1035
1116
|
{
|
@@ -1037,23 +1118,25 @@ Returns: _Array_ of Venues _Hash_
|
|
1037
1118
|
"address2": null,
|
1038
1119
|
"city": "Guadalajara",
|
1039
1120
|
"country": "MX",
|
1040
|
-
"created_at": "
|
1121
|
+
"created_at": "2008-05-09T09:29:23Z",
|
1041
1122
|
"id": 1,
|
1042
|
-
"latitude":
|
1043
|
-
"long_description":
|
1044
|
-
"longitude":
|
1123
|
+
"latitude": 20.666222,
|
1124
|
+
"long_description": null,
|
1125
|
+
"longitude": -103.352089,
|
1045
1126
|
"name": "Fbolko",
|
1127
|
+
"phone_number": null,
|
1046
1128
|
"state": "MX",
|
1129
|
+
"time_zone": "America/Mexico_City",
|
1047
1130
|
"upcoming_events_count": 0,
|
1048
|
-
"updated_at": "
|
1131
|
+
"updated_at": "2012-03-29T00:04:23Z",
|
1049
1132
|
"postalcode": null,
|
1050
|
-
"photos":
|
1051
|
-
|
1052
|
-
|
1053
|
-
|
1054
|
-
|
1055
|
-
|
1056
|
-
|
1133
|
+
"photos": {
|
1134
|
+
"thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
|
1135
|
+
"medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
|
1136
|
+
"large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
|
1137
|
+
"mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
|
1138
|
+
},
|
1139
|
+
"metro_area_id": null,
|
1057
1140
|
"url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
|
1058
1141
|
},
|
1059
1142
|
{
|
@@ -1074,32 +1157,33 @@ Params:
|
|
1074
1157
|
Returns: Venue _Hash_
|
1075
1158
|
|
1076
1159
|
``` js
|
1077
|
-
// Example: GET /api/
|
1160
|
+
// Example: GET /api/v3/venue/51886?api_key=1234567890abcdef
|
1078
1161
|
|
1079
1162
|
{
|
1080
|
-
"address1": "
|
1163
|
+
"address1": "201 Van Ness Avenue",
|
1081
1164
|
"address2": null,
|
1082
1165
|
"city": "San Francisco",
|
1083
1166
|
"country": "US",
|
1084
|
-
"created_at": "2008-04-
|
1085
|
-
"id":
|
1086
|
-
"latitude": 37.
|
1087
|
-
"long_description":
|
1088
|
-
"longitude": -122.
|
1089
|
-
"name": "
|
1167
|
+
"created_at": "2008-04-28T17:59:32Z",
|
1168
|
+
"id": 51886,
|
1169
|
+
"latitude": 37.777402,
|
1170
|
+
"long_description": null,
|
1171
|
+
"longitude": -122.419815,
|
1172
|
+
"name": "Davies Symphony Hall",
|
1173
|
+
"phone_number": "(415) 864-6000",
|
1090
1174
|
"state": "CA",
|
1091
|
-
"
|
1092
|
-
"
|
1093
|
-
"
|
1175
|
+
"time_zone": "America/Los_Angeles",
|
1176
|
+
"upcoming_events_count": 48,
|
1177
|
+
"updated_at": "2012-03-28T03:13:27Z",
|
1178
|
+
"postalcode": "94102",
|
1179
|
+
"photos": {
|
1180
|
+
"thumbnail": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
|
1181
|
+
"medium": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
|
1182
|
+
"large": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
|
1183
|
+
"mobile": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
|
1184
|
+
},
|
1094
1185
|
"metro_area_id": 105,
|
1095
|
-
"
|
1096
|
-
{
|
1097
|
-
"thumbnail": "http://i.tc-core.com/venue/_default/default-thumbnail.jpg",
|
1098
|
-
"medium": "http://i.tc-core.com/venue/_default/default-medium.jpg",
|
1099
|
-
"large": "http://i.tc-core.com/venue/_default/default-large.jpg",
|
1100
|
-
"mobile": "http://i.tc-core.com/venue/_default/default-mobile.jpg"
|
1101
|
-
}
|
1102
|
-
"url": "http://thrillcall.com/venue/Great_American_Music_Hall_in_San_Francisco_CA"
|
1186
|
+
"url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
|
1103
1187
|
}
|
1104
1188
|
```
|
1105
1189
|
|
@@ -1110,42 +1194,48 @@ Params:
|
|
1110
1194
|
|
1111
1195
|
- **[limit](#limit)**
|
1112
1196
|
- **[page](#page)**
|
1197
|
+
- **[time\_zone](#time_zone)**
|
1113
1198
|
- **[min\_date](#min_date)**
|
1114
1199
|
- **[max\_date](#max_date)**
|
1200
|
+
- **[min\_updated\_at](#min_updated_at)**
|
1201
|
+
- **[max\_updated\_at](#max_updated_at)**
|
1115
1202
|
- **[use\_partner\_id](#use_partner_id)**
|
1116
1203
|
- **[ticket\_type](#ticket_type)**
|
1117
1204
|
- **[must\_have\_tickets](#must_have_tickets)**
|
1205
|
+
- **[show\_disabled\_events](#show_disabled_events)**
|
1118
1206
|
- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
|
1119
1207
|
- **[show\_rumor\_events](#show_rumor_events)**
|
1120
1208
|
|
1121
1209
|
Returns: _Array_ of Events _Hash_
|
1122
1210
|
|
1123
1211
|
``` js
|
1124
|
-
// Example: GET /api/
|
1212
|
+
// Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef
|
1125
1213
|
|
1126
1214
|
[
|
1127
1215
|
{
|
1128
|
-
"created_at": "
|
1129
|
-
"end_date": null,
|
1216
|
+
"created_at": "2012-03-02T18:06:14Z",
|
1130
1217
|
"festival": false,
|
1131
|
-
"id":
|
1132
|
-
"latitude": 37.
|
1133
|
-
"
|
1134
|
-
"
|
1135
|
-
"name": "Colt Ford @ West Virginia State Fair",
|
1218
|
+
"id": 1047075,
|
1219
|
+
"latitude": 37.7915,
|
1220
|
+
"longitude": -122.413,
|
1221
|
+
"name": "Il Volo @ Masonic Center",
|
1136
1222
|
"on_sale_date": null,
|
1137
1223
|
"rumor": false,
|
1138
|
-
"start_date": "
|
1224
|
+
"start_date": "2012-09-29T19:30:04Z",
|
1225
|
+
"starts_at": "2012-09-30T02:30:04Z",
|
1226
|
+
"starts_at_time_trusted": true,
|
1139
1227
|
"unconfirmed_location": 0,
|
1140
|
-
"updated_at": "
|
1141
|
-
"venue_id":
|
1142
|
-
"photos":
|
1143
|
-
|
1144
|
-
|
1145
|
-
|
1146
|
-
|
1147
|
-
|
1148
|
-
"
|
1228
|
+
"updated_at": "2012-03-29T01:35:57Z",
|
1229
|
+
"venue_id": 63279,
|
1230
|
+
"photos": {
|
1231
|
+
"thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
|
1232
|
+
"large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
|
1233
|
+
"mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
|
1234
|
+
},
|
1235
|
+
"url": "http://thrillcall.com/event/1047075",
|
1236
|
+
"starts_at_local": "2012-09-29T19:30:04-07:00",
|
1237
|
+
"time_zone": "America/Los_Angeles"
|
1238
|
+
"status": "confirmed"
|
1149
1239
|
},
|
1150
1240
|
{
|
1151
1241
|
...
|
@@ -1169,33 +1259,34 @@ Params:
|
|
1169
1259
|
Returns: _Array_ of Venues _Hash_
|
1170
1260
|
|
1171
1261
|
``` js
|
1172
|
-
// Example: GET /api/
|
1262
|
+
// Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef
|
1173
1263
|
|
1174
1264
|
[
|
1175
1265
|
{
|
1176
|
-
"address1": "
|
1266
|
+
"address1": "525 W Riverview Ave",
|
1177
1267
|
"address2": null,
|
1178
|
-
"city": "
|
1268
|
+
"city": "Dayton",
|
1179
1269
|
"country": "US",
|
1180
|
-
"created_at": "2008-
|
1181
|
-
"id":
|
1182
|
-
"latitude":
|
1183
|
-
"long_description":
|
1184
|
-
"longitude": -
|
1185
|
-
"name": "
|
1186
|
-
"
|
1187
|
-
"
|
1188
|
-
"
|
1189
|
-
"
|
1190
|
-
"
|
1191
|
-
"
|
1192
|
-
|
1193
|
-
|
1194
|
-
|
1195
|
-
|
1196
|
-
|
1197
|
-
|
1198
|
-
"
|
1270
|
+
"created_at": "2008-06-12T14:12:53Z",
|
1271
|
+
"id": 33642,
|
1272
|
+
"latitude": 39.765526,
|
1273
|
+
"long_description": null,
|
1274
|
+
"longitude": -84.203133,
|
1275
|
+
"name": "Dayton Masonic Center",
|
1276
|
+
"phone_number": null,
|
1277
|
+
"state": "OH",
|
1278
|
+
"time_zone": "America/New_York",
|
1279
|
+
"upcoming_events_count": 0,
|
1280
|
+
"updated_at": "2012-03-28T03:11:49Z",
|
1281
|
+
"postalcode": "45405",
|
1282
|
+
"photos": {
|
1283
|
+
"thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
|
1284
|
+
"medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
|
1285
|
+
"large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
|
1286
|
+
"mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
|
1287
|
+
},
|
1288
|
+
"metro_area_id": 134,
|
1289
|
+
"url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
|
1199
1290
|
},
|
1200
1291
|
{
|
1201
1292
|
...
|
@@ -1226,20 +1317,24 @@ Params:
|
|
1226
1317
|
|
1227
1318
|
- **[limit](#limit)**
|
1228
1319
|
- **[page](#page)**
|
1320
|
+
- **[time\_zone](#time_zone)**
|
1229
1321
|
- **[min\_date](#min_date)**
|
1230
1322
|
- **[max\_date](#max_date)**
|
1323
|
+
- **[min\_updated\_at](#min_updated_at)**
|
1324
|
+
- **[max\_updated\_at](#max_updated_at)**
|
1231
1325
|
- **[lat](#lat)**
|
1232
1326
|
- **[long](#long)**
|
1233
1327
|
- **[postalcode](#postalcode)**
|
1234
1328
|
- **[radius](#radius)**
|
1235
1329
|
- **[ticket\_type](#ticket_type)**
|
1330
|
+
- **[show\_disabled\_events](#show_disabled_events)**
|
1236
1331
|
- **[show\_unconfirmed\_events](#show_unconfirmed_events)**
|
1237
1332
|
- **[show\_rumor\_events](#show_rumor_events)**
|
1238
1333
|
|
1239
1334
|
Returns: _Array_ of Tickets _Hash_
|
1240
1335
|
|
1241
1336
|
``` js
|
1242
|
-
// Example: GET /api/
|
1337
|
+
// Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef
|
1243
1338
|
|
1244
1339
|
[
|
1245
1340
|
{
|
@@ -1274,21 +1369,21 @@ Params:
|
|
1274
1369
|
Returns: Ticket _Hash_
|
1275
1370
|
|
1276
1371
|
``` js
|
1277
|
-
// Example: GET /api/
|
1372
|
+
// Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef
|
1278
1373
|
|
1279
1374
|
{
|
1280
|
-
"created_at": "
|
1375
|
+
"created_at": "2012-03-02T18:06:14Z",
|
1281
1376
|
"description": null,
|
1282
|
-
"event_id":
|
1283
|
-
"id":
|
1377
|
+
"event_id": 1047075,
|
1378
|
+
"id": 819883,
|
1284
1379
|
"marketing_text": null,
|
1285
|
-
"max_ticket_price":
|
1286
|
-
"min_ticket_price":
|
1287
|
-
"name": "
|
1380
|
+
"max_ticket_price": 85,
|
1381
|
+
"min_ticket_price": 29,
|
1382
|
+
"name": "Onsale to General Public",
|
1288
1383
|
"on_sale_end_date": null,
|
1289
1384
|
"on_sale_start_date": null,
|
1290
1385
|
"seat_info": null,
|
1291
|
-
"updated_at": "
|
1292
|
-
"url": "http://
|
1386
|
+
"updated_at": "2012-03-02T18:06:14Z",
|
1387
|
+
"url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
|
1293
1388
|
}
|
1294
1389
|
```
|