Incoming!

API Announcements and Goodies

If you're an Upcoming.org API developer, or planning to become one, read on...

Hot off the presses from yws-events...

We have changed our official API Endpoint URL from http://upcoming.org/services/rest/ to http://upcoming.yahooapis.com/services/rest/, effective immediately. Crossdomain.xml is ONLY be available through http://upcoming.yahooapis.com. All documentation now refers to upcoming.yahooapis.com, so please update your applications! If you haven't done it yet, now is a really good time to set the base URL for our API and auth entrypoints as a variable.

The original entrypoint for our API at http://upcoming.org/services/rest/ will still serve requests for the time being, but Flash applications will likely break and must be updated to the new URL (due to the crossdomain.xml change). We'll send out another email if the auth endpoint moves, too.

Why are we doing this? Two big reasons - we want to host an open crossdomain.xml file for our Flash developer community that doesn't put our users at risk, and we also want this new API domain to remain consistent in the long-term. Sorry for the inconvenience, but it really had to be done.

Also, we do want to let you know that big changes are afoot in the way that Upcoming handles geographic locations, and potentially user authentication. When we get everything ready, we will definitely announce any changes on the list, so keep your eyes peeled. Of course, we'll try to retain backwards compatibility as best we can, but there may be some growing pains coming up in the near future. We promise that it's for good reasons though, and hopefully will help to address many of the main issues that are present with the current API. For now, please do NOT bind any applications too closely to the Metro model.

Oh, and one more thing... as a major goodie that goes along with this change, I've thrown in a host of new attributes to some of the most frequently used API methods. I hope that they help make your applications quicker, and also give you a really good reason to open your editor and make this change. Enjoy! I've appended the list of new attributes at the end of this post for you to review.

---

THE GOOD STUFF

You've been asking for them forever, so here they are! Denormalized attributes are one of the most requested API features, and one of the ones we wanted to hold off on til we have proper versioning... but we just couldn't resist. Sorry!

event.getInfo now returns...

• venue_name


• venue_address


• venue_city


• venue_state_name


• venue_state_code


• venue_state_id


• venue_country_name


• venue_country_code


• venue_country_id


• venue_zip


• venue_url


• venue_phone

venue.getInfo now returns...

• state_name


• state_code


• state_id


• country_name


• country_code


• country_id

metro.getInfo/getList/getMyList/getForLatLon, and user.getMetroList/ now return...

• state_name


• state_code


• country_id


• country_name


• country_code

venue.getList now returns...

• address


• zip


• phone


• state_name


• state_code


• state_id


• country_name


• country_code


• country_id

user.getWatchlist/group.getEvents now return...

• venue_address


• venue_city


• venue_state_name


• venue_state_code


• venue_state_id


• venue_country_name


• venue_country_code


• venue_country_id


• venue_zip


• venue_url


• venue_phone

event.search now returns...

• venue_name


• venue_address


• venue_city


• venue_state_name


• venue_state_code


• venue_state_id


• venue_country_name


• venue_country_code


• venue_country_id


• venue_zip

metro.search now returns...

• state_id


• state_name


• country_id


• country_name

venue.search now returns...

• state_id


• state_code


• country_id


• country_code