More servicesWindows Live
HomeHotmailSpacesOneCare
 
MSN
Sign in
 
 
Spaces home  Spaces Developer Platfor...ProfileFriendsBlogMore Tools Explore the Spaces community

Blog

October 16

Windows Live Events: Create Event API and Event RSS

You’ve probably heard about the launch of Windows Live Events, but unless you’ve been using a web debugging proxy like Fiddler, you probably didn’t know that there’s a way to programmatically instantiate a Windows Live Event.  Try clicking this link:

http://spaces.live.com/api.aspx?wx_action=createEvent&wx_targetSite=eventSpace&wxp_name=Movie+Night:+Live+Free+or+Die+Hard&wxp_alias=livefreeordiehard&wxp_contactName=John+Smith&wxp_contactPhone=206-555-1212&wxp_location=Space+Needle&wxp_address=4th+Ave.+and+Broad+St.+in+Seattle&wxp_latlong=47.62061,-122.34942&wxp_mapType=h&wxp_mapZoom=18&wxp_description=%3cimg%20src='http://entimg.msn.com/i/150/mo/OneSheets/new3/LiveFreeorDieHard.jpg'%3e&wxp_template=IIEventOscarParty.xml

API Details
The link should have taken you to an event create page with all of the specified parameters pre-populated.  Yep, it’s a long link, but it’s intended to show all of the parameters (most of which are optional.)  Here’s the link in a more read-able format:

http://spaces.live.com/api.aspx
?wx_action=createEvent
&wx_targetSite=eventSpace
&wxp_name=Movie+Night:+Live+Free+or+Die+Hard
&wxp_alias=livefreeordiehard
&wxp_contactName=John+Smith
&wxp_contactPhone=206-555-1212
&wxp_location=Space+Needle
&wxp_address=4th+Ave.+and+Broad+St.+in+Seattle
&wxp_latlong=47.62061,-122.34942
&wxp_mapType=h
&wxp_mapZoom=18
&wxp_description=%3cimg%20src='http://entimg.msn.com/i/150/mo/OneSheets/new3/LiveFreeorDieHard.jpg'%3e
&wxp_template=IIEventOscarParty.xml

As you can see, parameters are URL encoded.   The mapping parameters (mapType, mapZoom) are consistent with Virtual Earth.  Check out their interactive SDK for more info. 

Potential uses
Below are just a few ideas for how you might use the Create Event API:

  • If you own a site that lists local events or venues like MSN CityGuides or eventful, the Create Event API will hopefully help you enable your users to easily create Windows Live Event spaces to invite their friends to the events that you listed
  • If you’re a local band, DJ, comic, etc., adding a create event link to your list of upcoming shows will make it easy for your fans to invite their friends
  • If you own a venue like a restaurant, bar, club, etc., consider adding a create event link to your website to help your visitors get their friends together at your establishment
  • If you’re a political candidate or advocacy organization, you could add a link to your website to make it easy for your supporters to create a coffee, house party, or debate watch party
  • If you’re an athletic team, you could add a great an event link to your game schedule so people could easily schedule an outing

These are just a few ideas for using the Create Event API.  I hope you find these useful and if you have feedback on the API or other suggestions for potential uses, please leave a comment.  Thanks—
--Rob

RSS
P.S. Publicly accessible events also include an RSS feed.  You can see this by adding /feed.rss to the event’s URL AND in additional to basic RSS elements like <title>, <link>, <description>, and <pubDate>; <geo> and <georss> elements are also included.

Update: 12 November 2007
Thanks to Thomas J. who pointed out the following:
* More full documentation will be posted on MSDN
* The "wx_targetSite" parameter is unnecessary

Comments (59)
To add a comment, you must sign in with your Windows Live ID (a Microsoft account like Hotmail, Messenger, or MSN). Sign in
Don't have a Windows Live ID? Sign up now
Add a comment

Comment (text only):
Trackbacks

The trackback URL for this entry is:
http://spacesplatform.spaces.live.com/blog/cns!AEA03ADE93DDFB95!223.trak
Weblogs that reference this entry
  • None