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
> >
>

Reply via email to