I can hack that together. ---Mark
http://twitter.com/mccv On Tue, May 4, 2010 at 3:54 PM, Zac Bowling <zbowl...@gmail.com> wrote: > Who is updating earlybird? :-P > Zac Bowling > > > On Tue, May 4, 2010 at 1:59 PM, Mark McBride <mmcbr...@twitter.com> wrote: >> >> The hydrated social events (as described in the previous email) are >> now live. Please let me know if you have questions/issues/concerns >> with the new data >> >> ---Mark >> >> http://twitter.com/mccv >> >> >> >> On Mon, May 3, 2010 at 10:50 AM, Mark McBride <mmcbr...@twitter.com> >> wrote: >> > Userstream previewers: >> > >> > Coming soon there will be a number of changes that may impact >> > applications. >> > >> > The first is support for OAuth 1.0a. When rolled out, you will be >> > able to sign requests to all streaming API endpoints on >> > betastream.twitter.com. This means that you can use OAuth with both >> > user streams and other streaming calls (filter, sample, etc.) To >> > obtain access tokens use the regular twitter.com OAuth flow, then sign >> > requests to betastream.twitter.com. If you already have an access >> > token you should be able to use it with the streaming API. >> > >> > The second is inclusion of fully hydrated objects for the social >> > events. Instead of just getting a source id, target id, and target >> > object id you will get the full user object in source and target >> > fields, and the full status in the target object field (if >> > applicable). You will also get a "created_at" field that indicates >> > the time the social event was created. This should dramatically reduce >> > the number of REST API calls needed to build a client. Note that most >> > parsers shouldn't need to change -- the ID field will still be set, >> > you will just have more fields available. The format is the same as >> > statuses retrieved via the rest API, with following exceptions: >> > >> > 1) The user's latest status may not be included >> > 2) The user's status count may not be included >> > 3) The user's favorites count may not be included >> > >> > An example of a hydrated social event is >> > >> > {"created_at"=>"Mon May 03 17:42:55 +0000 2010", >> > "target_object"=> >> > {"coordinates"=>nil, >> > "truncated"=>false, >> > "created_at"=>"Sun Jun 28 23:10:35 +0000 2009", >> > "favorited"=>false, >> > "contributors"=>nil, >> > "text"=>"looking at cricket eyes!", >> > "id"=>4, >> > "geo"=>nil, >> > "in_reply_to_user_id"=>nil, >> > "source"=>"web", >> > "place"=>nil, >> > "user"=> >> > {"profile_background_tile"=>false, >> > "name"=>"Ray", >> > "profile_sidebar_border_color"=>"87bc44", >> > "profile_sidebar_fill_color"=>"e0ff92", >> > "location"=>nil, >> > "created_at"=>"Mon Apr 12 00:00:00 +0000 2010", >> > "profile_image_url"=>"/images/default_profile_4_normal.png", >> > "profile_link_color"=>"0000ff", >> > "contributors_enabled"=>false, >> > "url"=>nil, >> > "favourites_count"=>1, >> > "id"=>4, >> > "utc_offset"=>-21600, >> > "profile_text_color"=>"000000", >> > "protected"=>true, >> > "lang"=>"en", >> > "followers_count"=>3, >> > "notifications"=>nil, >> > "verified"=>false, >> > "description"=>nil, >> > "profile_background_color"=>"9ae4e8", >> > "geo_enabled"=>false, >> > "time_zone"=>"Saskatchewan", >> > "profile_background_image_url"=>"/images/themes/theme1/bg.png", >> > "statuses_count"=>1, >> > "friends_count"=>3, >> > "screen_name"=>"ray", >> > "following"=>nil}, >> > "in_reply_to_screen_name"=>nil, >> > "in_reply_to_status_id"=>nil}, >> > "event"=>"favorite", >> > "target"=> >> > {"profile_background_tile"=>false, >> > "name"=>"Ray", >> > "profile_sidebar_border_color"=>"87bc44", >> > "profile_sidebar_fill_color"=>"e0ff92", >> > "location"=>nil, >> > "created_at"=>"Mon Apr 12 00:00:00 +0000 2010", >> > "profile_image_url"=>"/images/default_profile_4_normal.png", >> > "profile_link_color"=>"0000ff", >> > "contributors_enabled"=>false, >> > "url"=>nil, >> > "favourites_count"=>1, >> > "id"=>4, >> > "utc_offset"=>-21600, >> > "profile_text_color"=>"000000", >> > "protected"=>true, >> > "lang"=>"en", >> > "followers_count"=>3, >> > "notifications"=>nil, >> > "verified"=>false, >> > "description"=>nil, >> > "profile_background_color"=>"9ae4e8", >> > "geo_enabled"=>false, >> > "time_zone"=>"Saskatchewan", >> > "profile_background_image_url"=>"/images/themes/theme1/bg.png", >> > "statuses_count"=>1, >> > "friends_count"=>3, >> > "screen_name"=>"ray", >> > "following"=>nil}, >> > "source"=> >> > {"profile_background_tile"=>false, >> > "name"=>"Jack", >> > "profile_sidebar_border_color"=>"87bc44", >> > "profile_sidebar_fill_color"=>"e0ff92", >> > "location"=>"San Francisco", >> > "created_at"=>"Wed Apr 28 00:00:00 +0000 2010", >> > "profile_image_url"=> >> > >> > "http://s3.amazonaws.com/twitter_development/profile_images/2/jack_normal.jpg", >> > "profile_link_color"=>"0000ff", >> > "contributors_enabled"=>false, >> > "url"=>nil, >> > "favourites_count"=>0, >> > "id"=>3, >> > "utc_offset"=>-28800, >> > "profile_text_color"=>"000000", >> > "protected"=>true, >> > "lang"=>"en", >> > "followers_count"=>2, >> > "notifications"=>nil, >> > "verified"=>false, >> > "description"=>"love, love", >> > "profile_background_color"=>"9ae4e8", >> > "geo_enabled"=>false, >> > "time_zone"=>"Pacific Time (US & Canada)", >> > "profile_background_image_url"=>"/images/themes/theme1/bg.png", >> > "statuses_count"=>1, >> > "friends_count"=>2, >> > "screen_name"=>"jack", >> > "following"=>nil}} >> > >> > The third is an improvement to the direct message payload. Currently >> > it's a bit of a pain to disambiguate statuses and DMs. We'll be >> > wrapping direct messages in a higher level "direct_message" object, >> > e.g. >> > >> > {"direct_message"=> >> > {"created_at"=>"Wed Apr 28 14:56:31 +0000 2010", >> > "sender_screen_name"=>"user1", >> > "sender"=> >> > {"profile_background_tile"=>false, >> > "name"=>"User1", >> > "profile_sidebar_border_color"=>"87bc44", >> > "profile_sidebar_fill_color"=>"e0ff92", >> > "location"=>"San Francisco", >> > "created_at"=>"Wed Apr 28 00:00:00 +0000 2010", >> > "profile_image_url"=> >> > >> > "http://s3.amazonaws.com/twitter_development/profile_images/2/user1_normal.jpg", >> > "profile_link_color"=>"0000ff", >> > "contributors_enabled"=>false, >> > "url"=>nil, >> > "favourites_count"=>0, >> > "id"=>3, >> > "utc_offset"=>-28800, >> > "profile_text_color"=>"000000", >> > "protected"=>true, >> > "lang"=>"en", >> > "followers_count"=>2, >> > "notifications"=>nil, >> > "verified"=>false, >> > "description"=>"love, love", >> > "profile_background_color"=>"9ae4e8", >> > "geo_enabled"=>false, >> > "time_zone"=>"Pacific Time (US & Canada)", >> > "profile_background_image_url"=>"/images/themes/theme1/bg.png", >> > "statuses_count"=>1, >> > "friends_count"=>2, >> > "screen_name"=>"user1", >> > "following"=>nil}, >> > "text"=>"holy calamity scream insanity", >> > "recipient_screen_name"=>"user2", >> > "id"=>1, >> > "recipient"=> >> > {"profile_background_tile"=>false, >> > "name"=>"User2", >> > "profile_sidebar_border_color"=>"87bc44", >> > "profile_sidebar_fill_color"=>"e0ff92", >> > "location"=>nil, >> > "created_at"=>"Mon Feb 01 00:00:00 +0000 2010", >> > "profile_image_url"=>"/images/default_profile_5_normal.png", >> > "profile_link_color"=>"0000ff", >> > "contributors_enabled"=>true, >> > "url"=>"http://twitter.com/user2", >> > "favourites_count"=>0, >> > "id"=>5, >> > "utc_offset"=>19800, >> > "profile_text_color"=>"000000", >> > "protected"=>true, >> > "lang"=>"en", >> > "followers_count"=>4, >> > "notifications"=>nil, >> > "verified"=>false, >> > "description"=>nil, >> > "profile_background_color"=>"9ae4e8", >> > "geo_enabled"=>false, >> > "time_zone"=>"Mumbai", >> > "profile_background_image_url"=>"/images/themes/theme1/bg.png", >> > "statuses_count"=>7, >> > "friends_count"=>4, >> > "screen_name"=>"user2", >> > "following"=>nil}, >> > "recipient_id"=>5, >> > "sender_id"=>3}} >> > >> > Given this structure, all messages are easily disambiguated by looking >> > at the first level of keys in the JSON message >> > >> > 1) If the key "text" exists, this is a status >> > 2) If the key "delete" exists, this is a status deletion >> > 3) If the key "scrub_geo" exists, this is a geo-tagging deletion message >> > 4) If the key "direct_message" exists, this is a direct message >> > 5) If the key "event" exists, this is a social event >> > >> > We realize that email isn't the best way to keep this documented in >> > the long term, and we're working on getting this information onto >> > dev.twitter.com. We'll send out additional notices as these become >> > available, but we wanted to let you know these changes were coming. >> > >> > ---Mark >> > >> > http://twitter.com/mccv >> > > >