[twitter-dev] Re: Purposed method: friendships/show

2009-06-09 Thread Marcel Molina

Hey Chad, thanks for your feedback.

Thought experiment: Put aside the currently proposed response body for
the moment. How would you unambiguously express the following/followed
by relationship?

Marcel Molina
Twitter API Team
http://twitter.com/@noradio

On Jun 9, 10:23 am, Chad Etzel  wrote:
> Thanks for adding the extra verbiage.
>
> However, I'm still not clear how to decipher the exact relationship
> given the data.  In the example, is Bob following Jack? ...or is Jack
> following Bob?
>
> -Chad
>
>
>
> On Tue, Jun 9, 2009 at 1:12 PM, Doug Williams  wrote:
> > Thanks, Chad. I've augmented the usage notes section to explain the
> > rationale behind the denormalized and redundant data.
> > Thanks,
> > Doug
>
> > On Tue, Jun 9, 2009 at 9:47 AM, Chad Etzel  wrote:
>
> >> Taking a look at the json return example:
> >> {"relationship": {
> >> "source": {
> >> "id": 123,
> >> "screen_name": "bob",
> >> "following": true,
> >> "followed_by": false,
> >> "notifications": false },
>
> >> "target": {
> >> "id": 456,
> >> "screen_name": "jack",
> >> "following": false,
> >> "followed_by": true,
> >> "notifications": null }
> >> }
> >> }
>
> >> In the "source" object (i.e. for "bob"), "following" is true.  Does
> >> this mean that Bob is following Jack, or vice-versa?
>
> >> Knowing that, the other 3 following/followed_by value meanings can be
> >> properly inferred.  Some clarification on the page would help.
>
> >> -Chad
>
> >> On Tue, Jun 9, 2009 at 12:40 PM, Doug Williams  wrote:
> >> > That makes things difficult. Permissions are now public.
> >> > Thanks,
> >> > Doug
>
> >> > On Tue, Jun 9, 2009 at 9:39 AM, Chad Etzel  wrote:
>
> >> >> 
> >> >> Access Denied
>
> >> >> You don't have permission to look at Twitter REST API Method:
> >> >> friendships
> >> >> show.
> >> >> 
>
> >> >> :)
> >> >> -Chad
>
> >> >> On Tue, Jun 9, 2009 at 12:32 PM, Doug Williams 
> >> >> wrote:
> >> >> > We discussed the need to deprecate the  and
> >> >> > 
> >> >> > elements [1] a few weeks back. We have begun work on the
> >> >> > friendships/show
> >> >> > method as mentioned in the notice. The method is slightly out of our
> >> >> > conventional design, so we are soliciting opinions on its fitness for
> >> >> > general use-cases. Please peruse the purposed method's documentation
> >> >> > [2]
> >> >> > and
> >> >> > let us know what you think.
>
> >> >> > 1. http://groups.google.com/group/twitter-development-talk/browse_frm/th...
>
> >> >> > 2. http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-friendships-show
> >> >> > Thanks,
> >> >> > Doug


[twitter-dev] Re: Purposed method: friendships/show

2009-06-09 Thread Marcel Molina
Thanks for the suggestion Chad.
What do others think of

{"relationship": {
 "source": {
   "id": 123,
   "screen_name": "bob",
   "notifications": false },

 "target": {
   "id": 456,
   "screen_name": "jack",
   "notifications": null },

 "source_follows_target": true,
 "source_followed_by_target": false
}
}

versus

{"relationship": {

"source": {

"id": 123,

"screen_name": "bob",

"following": true,

"followed_by": false,

"notifications_enabled": false },

"target": {

"id": 456,

"screen_name": "jack",

"following": false,

"followed_by": true,

"notifications_enabled": null }

}

}



On Tue, Jun 9, 2009 at 10:41 AM, Chad Etzel  wrote:

>
> Hi Marcel,
>
> Welcome to Twitter, btw (if I'm allowed to say that).
>
> One unambiguous way might be:
>
> {"relationship": {
>  "source": {
>"id": 123,
>"screen_name": "bob",
> "notifications": false },
>
>  "target": {
>"id": 456,
>"screen_name": "jack",
> "notifications": null },
>
>  "source_follows_target": true,
>  "source_followed_by_target": false
> }
> }
>
> This also eliminates redundant data.
>
> Btw, http://twitter.com/@noradio doesn't quite work as a link :)
>
> -Chad
>
> On Tue, Jun 9, 2009 at 1:33 PM, Marcel  Molina  wrote:
> >
> > Hey Chad, thanks for your feedback.
> >
> > Thought experiment: Put aside the currently proposed response body for
> > the moment. How would you unambiguously express the following/followed
> > by relationship?
> >
> > Marcel Molina
> > Twitter API Team
> > http://twitter.com/@noradio
> >
> > On Jun 9, 10:23 am, Chad Etzel  wrote:
> >> Thanks for adding the extra verbiage.
> >>
> >> However, I'm still not clear how to decipher the exact relationship
> >> given the data.  In the example, is Bob following Jack? ...or is Jack
> >> following Bob?
> >>
> >> -Chad
> >>
> >>
> >>
> >> On Tue, Jun 9, 2009 at 1:12 PM, Doug Williams  wrote:
> >> > Thanks, Chad. I've augmented the usage notes section to explain the
> >> > rationale behind the denormalized and redundant data.
> >> > Thanks,
> >> > Doug
> >>
> >> > On Tue, Jun 9, 2009 at 9:47 AM, Chad Etzel 
> wrote:
> >>
> >> >> Taking a look at the json return example:
> >> >> {"relationship": {
> >> >> "source": {
> >> >> "id": 123,
> >> >> "screen_name": "bob",
> >> >> "following": true,
> >> >> "followed_by": false,
> >> >> "notifications": false },
> >>
> >> >> "target": {
> >> >> "id": 456,
> >> >> "screen_name": "jack",
> >> >> "following": false,
> >> >> "followed_by": true,
> >> >> "notifications": null }
> >> >> }
> >> >> }
> >>
> >> >> In the "source" object (i.e. for "bob"), "following" is true.  Does
> >> >> this mean that Bob is following Jack, or vice-versa?
> >>
> >> >> Knowing that, the other 3 following/followed_by value meanings can be
> >> >> properly inferred.  Some clarification on the page would help.
> >>
> >> >> -Chad
> >>
> >> >> On Tue, Jun 9, 2009 at 12:40 PM, Doug Williams 
> wrote:
> >> >> > That makes things difficult. Permissions are now public.
> >> >> > Thanks,
> >> >> > Doug
> >>
> >> >> > On Tue, Jun 9, 2009 at 9:39 AM, Chad Etzel 
> wrote:
> >>
> >> >> >> 
> >> >> >> Access Denied
> >>
> >> >> >> You don't have permission to look at Twitter REST API Method:
> >> >> >> friendships
> >> >> >> show.
> >> >> >> 
> >>
> >> >> >> :)
> >> >> >> -Chad
> >>
> >> >> >> On Tue, Jun 9, 2009 at 12:32 PM, Doug Williams 
> >> >> >> wrote:
> >> >> >> > We discussed the need to deprecate the  and
> >> >> >> > 
> >> >> >> > elements [1] a few weeks back. We have begun work on the
> >> >> >> > friendships/show
> >> >> >> > method as mentioned in the notice. The method is slightly out of
> our
> >> >> >> > conventional design, so we are soliciting opinions on its
> fitness for
> >> >> >> > general use-cases. Please peruse the purposed method's
> documentation
> >> >> >> > [2]
> >> >> >> > and
> >> >> >> > let us know what you think.
> >>
> >> >> >> > 1.
> http://groups.google.com/group/twitter-development-talk/browse_frm/th...
> >>
> >> >> >> > 2.
> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-friendships-show
> >> >> >> > Thanks,
> >> >> >> > Doug
> >
>



-- 
Marcel Molina
Twitter API Team
http://twitter.com/noradio


[twitter-dev] Re: Purposed method: friendships/show

2009-06-09 Thread Marcel Molina
Good point about pending requests for protected accounts and the opportunity
to get parity.
My inclination is rather than overloading following and followed_by that we
potentially introduce a 'pending' attribute that is either true or empty.
Similarly we could add a 'blocked'/'blocked_by'.

These additional attributes sway me toward going with the
representation that (redundantly) specifies the values of each
attribute with the source and target sections as encoding this
information in 'source_has_a_pending_request_for_target' and
'target_has_a_pending_request_for_source', etc start to get somewhat
unwieldy.

On Tue, Jun 9, 2009 at 4:29 PM, jim.renkel  wrote:

>
> It seems from the examples, but not explicitly stated anywhere, that
> the values of the following and followed_by items are booleans,
> implying that a user either is or is not following another user.
>
> While at first blush that seems true, I think in reality the situation
> is a little more complicated, especially if you consider protected
> users.
>
> I would propose that these items be enumerations, with the following
> values and meanings:
> - "yes": user A, say, is following user B;
> - "no": user A is not following user B, has not requested the
> relationship, and is not blocked from doing so;
> - "pending": user A has requested to follow (protected) user B, but B
> has not yet accepted, rejected, or blocked the request; and
> - "blocked": user A requested to follow (protected) user B, but B
> blocked the request.
>
> What I'm looking for here is parity, if you will, between the data and
> facilities that are available to the twitter.com web site and to API
> users. This is one place where there was not parity, and we have the
> opportunity to now get it.
>
> Comments expected, welcome, and appreciated.
>
> Jim Renkel
>
> On Jun 9, 1:13 pm, Damon Clinkscales  wrote:
> > If you're going to redefine the way that follow information is
> > returned, I believe that it should include the effect of "protected"
> > accounts on both sides of the follow equation.
> >
> > Thanks,
> > -damon
> > --http://twitter.com/damon
> >
> > On Tue, Jun 9, 2009 at 10:52 AM, Marcel Molina
> wrote:
> > > Thanks for the suggestion Chad.
> > > What do others think of
> > > {"relationship": {
> > >  "source": {
> > >"id": 123,
> > >"screen_name": "bob",
> > >"notifications": false },
> >
> > >  "target": {
> > >"id": 456,
> > >"screen_name": "jack",
> > >"notifications": null },
> >
> > >  "source_follows_target": true,
> > >  "source_followed_by_target": false
> > > }
> > > }
> > > versus
> >
> > > {"relationship": {
> >
> > > "source": {
> >
> > > "id": 123,
> >
> > > "screen_name": "bob",
> >
> > > "following": true,
> >
> > > "followed_by": false,
> >
> > > "notifications_enabled": false },
> >
> > > "target": {
> >
> > > "id": 456,
> >
> > > "screen_name": "jack",
> >
> > > "following": false,
> >
> > > "followed_by": true,
> >
> > > "notifications_enabled": null }
> >
> > > }
> >
> > > }
>



-- 
Marcel Molina
Twitter API Team
http://twitter.com/noradio


[twitter-dev] Re: Purposed method: friendships/show

2009-06-09 Thread Marcel Molina
Though, it should be mentioned, w/r/t/ to pending follow requests and
blocks, you'd only get a value for those attributes for authenticated
requests where the source user is authenticated.

On Tue, Jun 9, 2009 at 5:22 PM, Marcel Molina  wrote:

> Good point about pending requests for protected accounts and the
> opportunity to get parity.
> My inclination is rather than overloading following and followed_by that we
> potentially introduce a 'pending' attribute that is either true or empty.
> Similarly we could add a 'blocked'/'blocked_by'.
>
> These additional attributes sway me toward going with the
> representation that (redundantly) specifies the values of each attribute with 
> the source and target sections as encoding this information in 
> 'source_has_a_pending_request_for_target' and 
> 'target_has_a_pending_request_for_source', etc start to get somewhat unwieldy.
>
>
> On Tue, Jun 9, 2009 at 4:29 PM, jim.renkel  wrote:
>
>>
>> It seems from the examples, but not explicitly stated anywhere, that
>> the values of the following and followed_by items are booleans,
>> implying that a user either is or is not following another user.
>>
>> While at first blush that seems true, I think in reality the situation
>> is a little more complicated, especially if you consider protected
>> users.
>>
>> I would propose that these items be enumerations, with the following
>> values and meanings:
>> - "yes": user A, say, is following user B;
>> - "no": user A is not following user B, has not requested the
>> relationship, and is not blocked from doing so;
>> - "pending": user A has requested to follow (protected) user B, but B
>> has not yet accepted, rejected, or blocked the request; and
>> - "blocked": user A requested to follow (protected) user B, but B
>> blocked the request.
>>
>> What I'm looking for here is parity, if you will, between the data and
>> facilities that are available to the twitter.com web site and to API
>> users. This is one place where there was not parity, and we have the
>> opportunity to now get it.
>>
>> Comments expected, welcome, and appreciated.
>>
>> Jim Renkel
>>
>> On Jun 9, 1:13 pm, Damon Clinkscales  wrote:
>> > If you're going to redefine the way that follow information is
>> > returned, I believe that it should include the effect of "protected"
>> > accounts on both sides of the follow equation.
>> >
>> > Thanks,
>> > -damon
>> > --http://twitter.com/damon
>> >
>> > On Tue, Jun 9, 2009 at 10:52 AM, Marcel Molina
>> wrote:
>> > > Thanks for the suggestion Chad.
>> > > What do others think of
>> > > {"relationship": {
>> > >  "source": {
>> > >"id": 123,
>> > >"screen_name": "bob",
>> > >"notifications": false },
>> >
>> > >  "target": {
>> > >"id": 456,
>> > >"screen_name": "jack",
>> > >"notifications": null },
>> >
>> > >  "source_follows_target": true,
>> > >  "source_followed_by_target": false
>> > > }
>> > > }
>> > > versus
>> >
>> > > {"relationship": {
>> >
>> > > "source": {
>> >
>> > > "id": 123,
>> >
>> > > "screen_name": "bob",
>> >
>> > > "following": true,
>> >
>> > > "followed_by": false,
>> >
>> > > "notifications_enabled": false },
>> >
>> > > "target": {
>> >
>> > > "id": 456,
>> >
>> > > "screen_name": "jack",
>> >
>> > > "following": false,
>> >
>> > > "followed_by": true,
>> >
>> > > "notifications_enabled": null }
>> >
>> > > }
>> >
>> > > }
>>
>
>
>
> --
> Marcel Molina
> Twitter API Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter API Team
http://twitter.com/noradio


[twitter-dev] Re: twitter api server seems to be down (getting invalid signature) since 5.15 pm pst

2009-07-28 Thread Marcel Molina
gt; > On Jul 28, 11:40 am, Zaudio  wrote:
>> > > > I don't myself think that twitter are doing anything more than
>> > > > enforcing the standard. I spent 3 hours 'fixing' my code for our
>> > > > application (uses Shannon Whitley's c# library as a base); I only
>> > > > found two bugs in thelibrary that caused any problem... the use of
>> > > > httputility.urlencode in place of the modified urlencode already
>> > > > implemented for use with Oauth, as required by the spec... the
>> library
>> > > > just wasn't using it in two places.
>> >
>> > --
>> > Cristovao Morgado
>> > aka Saintrhttp://www.oMeuJogoUsado.comhttp://www.TweetaPorSMS.comhttp://
>> twitter.com/TheSaintr
>>
>
>
>
> --
> Abraham Williams | Community Evangelist | http://web608.org
> Hacker | http://abrah.am | http://twitter.com/abraham
> Project | http://fireeagle.labs.poseurtech.com
> This email is: [ ] blogable [x] ask first [ ] private.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Help signing OAuth requests

2009-07-30 Thread Marcel Molina
For those who might be struggling to ensure their OAuth signatures are being
generated correctly, this
guide provides more hand holding with the process than the specification.
It includes custom forms where you can fill out all the details of
your request and see what the signature and
its related data *should* be.

http://www.hueniverse.com/hueniverse/2008/10/beginners-gui-1.html

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Twitpocalypse: The Second Coming is on the horizon

2009-07-31 Thread Marcel Molina

Twitter status ids are fast approaching the maximum 32-bit *unsigned*
integer value (4,294,967,295).

The current estimate is that this will occur in approximately 60 days,
at the end of September. The 60 day window is a best-guess
approximation based on projections. It could conceivably happen
sooner.

Developers are encouraged to not only update their applications to use
a 64-bit integer (BIGINT/long long), but also verify that all
libraries they use are also prepared to handle 64-bit integers.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Early developer preview: Retweeting API

2009-08-13 Thread Marcel Molina

Retweeting has become one of the cultural conventions of the Twitter
experience. It's yet another example of Twitter's users discovering
innovative ways to use the service. We dig it. So soon it's going to
become a natively supported feature on twitter.com. It's looking like
we're only weeks away from being ready to launch it on our end. We
wanted to show the community of platform developers the API we've
cooked up for retweeting so those who want to support it in their
applications would have enough time to have it ready by launch day. We
were planning on exposing a way for developers to create a retweet,
recognize retweets in your timeline and display them distinctively
amongst other tweets. We've also got APIs for several retweet
timelines: retweets you've created, retweets the users you're
following have created, and your tweets that have been retweeted by
others.

- Creating Retweets

The API documentation for creating retweets can be found here:

http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweet

Reminder: Making requests to /statuses/retweet won't work yet as the
feature has not launched.

- Consuming Retweets in the Timeline

1) Retweets in the new home timeline

We don't want to break existing apps that don't add retweeting support
or create a confusing experience for that app's users. So the
/statuses/friends_timeline API resource will remain unchanged--i.e.
retweets will *not* appear in it.

For those who *do* want to support retweets, we are adding a new (more
aptly named) /statuses/home_timeline resource. This *will* include
retweets. The /statuses/friends_timeline API resource will continue to
be supported in version 1 of the API. In version 2 it will go away and
be fully replaced by /statuses/home_timeline.

The API documentation for the home timeline, which includes retweets,
can be found here:

http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-home_timeline

Take a look at the example payload in the documentation. The original
tweet that was retweeted Thanks appears in the timeline. Notice the
embedded "retweet_details" element. It contains the user who created
the retweet as well as the date and time the retweet occurred.

2) Retweeted by me timeline
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweeted_by_me

3) Retweeted to me timeline
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweeted_to_me

4) My tweets, retweeted
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweets_of_me

Reminder: Making requests to any of these timelines won't work yet as
the feature has not launched.

UI considerations:
--

Here are some early draft design mockups of how retweets might appear
on the Twitter website (don't be surprised if
it doesn't look exactly like this). They are presented just as an
example of how retweets can be differentiated visually.

http://s.twimg.com/retweet-dev-mocks-7-aug-09.png

Things to note:

1) It was important for us that retweets are easily differentiated
visually from regular tweets. If someone you follow retweets a tweet,
the original tweet will appear in your timeline whether you follow the
author of the original tweet or not, just as it currently does when
users use the "RT" convention. Seeing a tweet in your timeline from
someone you don't follow without being told it was shared from someone
you *do* follow could be confusing. So we're encouraging developers to
be mindful of this confusion and make retweets stand out visually from
regular tweets.

2) The retweeted tweet shows the username of the first of your
followers to retweet it. If other's subsequently retweet the same
tweet, the retweet should only appear once in a user's timeline

That's it for now.

We'll be sending out more updates as we get closer to launching.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Early developer preview: Retweeting API

2009-08-17 Thread Marcel Molina
;retweet_id' to the
retweet_details section.

> 8. If a protected user retweets a status update of a non-protected
> user, will the protected user always / sometimes / never be listed as
> a retweeter of the public user's status update?
>
> 9. Conversely, if a non-protected user retweets a status update of a
> protected user, will the protected status update always / sometimes /
> never be included in the various timelines of the non-protected user?

Security/visibility concerns are the same as with any status update.

>
> On Aug 13, 3:52 pm, Marcel Molina  wrote:
>> Retweetinghas become one of the cultural conventions of the Twitter
>> experience. It's yet another example of Twitter's users discovering
>> innovative ways to use the service. We dig it. So soon it's going to
>> become a natively supported feature on twitter.com. It's looking like
>> we're only weeks away from being ready to launch it on our end. We
>> wanted to show the community of platform developers theAPIwe've
>> cooked up forretweetingso those who want to support it in their
>> applications would have enough time to have it ready by launch day. We
>> were planning on exposing a way for developers to create a retweet,
>> recognize retweets in your timeline and display them distinctively
>> amongst other tweets. We've also got APIs for several retweet
>> timelines: retweets you've created, retweets the users you're
>> following have created, and your tweets that have been retweeted by
>> others.
>>
>> - Creating Retweets
>>
>> TheAPIdocumentation for creating retweets can be found here:
>>
>> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweet
>>
>> Reminder: Making requests to /statuses/retweet won't work yet as the
>> feature has not launched.
>>
>> - Consuming Retweets in the Timeline
>>
>> 1) Retweets in the new home timeline
>>
>> We don't want to break existing apps that don't addretweetingsupport
>> or create a confusing experience for that app's users. So the
>> /statuses/friends_timelineAPIresource will remain unchanged--i.e.
>> retweets will *not* appear in it.
>>
>> For those who *do* want to support retweets, we are adding a new (more
>> aptly named) /statuses/home_timeline resource. This *will* include
>> retweets. The /statuses/friends_timelineAPIresource will continue to
>> be supported in version 1 of theAPI. In version 2 it will go away and
>> be fully replaced by /statuses/home_timeline.
>>
>> TheAPIdocumentation for the home timeline, which includes retweets,
>> can be found here:
>>
>> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-home_t...
>>
>> Take a look at the example payload in the documentation. The original
>> tweet that was retweeted Thanks appears in the timeline. Notice the
>> embedded "retweet_details" element. It contains the user who created
>> the retweet as well as the date and time the retweet occurred.
>>
>> 2) Retweeted by me 
>> timelinehttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retwee...
>>
>> 3) Retweeted to me 
>> timelinehttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retwee...
>>
>> 4) My tweets, 
>> retweetedhttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retwee...
>>
>> Reminder: Making requests to any of these timelines won't work yet as
>> the feature has not launched.
>>
>> UI considerations:
>> --
>>
>> Here are someearlydraft design mockups of how retweets might appear
>> on the Twitter website (don't be surprised if
>> it doesn't look exactly like this). They are presented just as an
>> example of how retweets can be differentiated visually.
>>
>> http://s.twimg.com/retweet-dev-mocks-7-aug-09.png
>>
>> Things to note:
>>
>> 1) It was important for us that retweets are easily differentiated
>> visually from regular tweets. If someone you follow retweets a tweet,
>> the original tweet will appear in your timeline whether you follow the
>> author of the original tweet or not, just as it currently does when
>> users use the "RT" convention. Seeing a tweet in your timeline from
>> someone you don't follow without being told it was shared from someone
>> you *do* follow could be confusing. So we're encouraging developers to
>> be mindful of this confusion and make retweets stand out visually from
>> regular tweets.
>>
>> 2) The retweeted tweet shows the username of the first of your
>> followers to retweet it. If other's subsequently retweet the same
>> tweet, the retweet should only appear once in a user's timeline
>>
>> That's it for now.
>>
>> We'll be sending out more updates as we get closer to launching.
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Retweet API addition: retweet_id

2009-08-17 Thread Marcel Molina

We've added a retweet_id to the retweet_details section to allow for,
e.g. deletion of retweets. The retweet_id can be provided as an
argument to statuses/destroy.

The example payloads have been updated to include retweet_id.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Join us in the #twitterapi IRC channel on freenode

2009-08-18 Thread Marcel Molina

We've heard your requests for greater transparency and more frequent
communication in the last couple weeks around the fall out from the
DDoS attacks. The Twitter Development Talk mailing list and
@twitterapi account have gone a long way to keeping the conversation
flowing. We want to facilitate even more modes of communication
though. So we've opened up the #twitterapi IRC channel on
irc.freenode.net. We hope to be able to provide some real-time support
when things go awry. Unfortunately, we can't provide 24/7 support via
IRC, but we'll try to be around during deploys, unexpected outages,
and special events. We also envision it as a place for developers to
help each other. So, if you're into IRC, we encourage you to come on
over.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Join us in the #twitterapi IRC channel on freenode

2009-08-18 Thread Marcel Molina

The channel had been set to +r which requires users to be registered
with the NickServ to join the channel. That restriction has been
lifted so things should be fine now (and since you just joined the
channel I'm assuming it works).

On Tue, Aug 18, 2009 at 4:29 PM, Dewald Pretorius wrote:
>
> Marcel,
>
> I can't join #twitterapi on irc.freenode.net. Colloquy-mobile just
> throws a deaf ear, i.e., nothing happens. I can join other chat rooms
> no problem.
>
> I'm not very familiar with IRC, so I might be making a rookie mistake.
>
> Dewald
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] [ANN] statuses/home_timeline resource now available (though it doesn't include retweets yet)

2009-09-02 Thread Marcel Molina

We mentioned in our early preview email about the retweet API
(http://groups.google.com/group/twitter-api-announce/browse_thread/thread/1e07e332ec3d449d)
that the statuses/friends_timeline resource wasn't going to include
retweets for backwards compatibility so we don't break clients that
aren't planning to add retweet support. The upgrade path is entirely
opt-in. To that end we're adding a statuses/home_timeline resource
that is in all ways identical to statuses/friends_timeline except the
home_timeline resource *will* include retweets as demonstrated in the
example payload in the documentation at
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-home_timeline.

The statuses/home_timeline resource is now available though it won't
include any retweets until the retweeting feature is fully launched.
To be clear, until the full retweet launch, statuses/home_timeline
will be 100% identical to statuses/friends_timeline and will *not*
include retweets. We wanted to make the resource available early
though so that clients who will be incorporating retweets into their
timelines can update the resource that they reference and have
requests succeed. When the full retweet launch happens, retweets will
start to appear in statuses/home_timeline as per the documentation.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Retweet API and multiple retweets in timeline

2009-09-02 Thread Marcel Molina

If you take a look at the payload of a retweet in the examples, each
retweet has the id of the original tweet as well as details about the
retweet (who retweeted it, when and what the id of the retweet is).
That information, specifically the retweet's id, should be sufficient
for your purposes.

On Wed, Sep 2, 2009 at 2:58 PM, hansamann wrote:
>
> Hi all,
>
> this questions might have been asked already, but a quick search in
> this mailing list did not lead me to a clear response... so I
> apologize if this topic was discussed in detail already.
>
> My question:
>
> - if a tweet is retweeted several timese, e.g. tweet X is retweeted by
> my friend A and my friend B, it is likely these retweets are not
> taking place the same time.
>
> - my assumption and question is if the 2 retweets in this case show up
> as two tweets in the home timeline. What troubles me is how I can
> detect that a tweet was retweeted. I intend to save the last pulled
> statusId and then just pull tweets from the home_timeline from the
> last statusId. I hope to get the 'new retweets' as they happen as new
> people are retweeting. If the api will aggregate the retweets under
> the stausId of the original message, I will not be updated of new
> retweets in this case. On the other side, if a new retweet will add
> the original status a second time (possibly with the new total
> retweets, e.g. several retweet_details) then I track the retweet
> count.
>
> What do you think?
>
> Cheers
> Sven
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: [ANN] statuses/home_timeline resource now available (though it doesn't include retweets yet)

2009-09-02 Thread Marcel Molina

The current friends_timeline and home_timeline both include mentions
already. The friends_timeline will continue to not include retweets
since the payload for a retweeted status is slightly different. At
some future time, though, the friends_timeline will be removed in
favor of the home_timeline, which will include retweets. Having both
parallel timelines, with one that does not include retweets is just a
stop gap measure to ease the upgrade path.

On Wed, Sep 2, 2009 at 4:56 PM, TjL wrote:
>
> from the API page
>
>> Twitter REST API Method: statuses/home_timeline [COMING SOON]
>> Returns the 20 most recent statuses, including retweets, posted by the 
>> authenticating user and that user's friends. This is the equivalent of 
>> /timeline/home on the Web.
>>
>> Usage note: This home_timeline is identical to statuses/friends_timeline 
>> except it also contains retweets, which statuses/friends_timeline does not 
>> (for backwards compatibility reasons). In a future version of the API, 
>> statuses/friends_timeline will go away and be replaced by home_timeline.
>>
>
> Does this mean that "in a future version of the API" there won't be
> any way to get a friends timeline without retweets?
>
> Because the ability to ignore retweets ought to be a Day 1 feature, IMO.
>
> I would put a much higher value on a unified feed which includes
> "*mentions* and friends" than "*retweets* and friends"
>
> FWIW
>
> TjL
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: [ANN] statuses/home_timeline resource now available (though it doesn't include retweets yet)

2009-09-03 Thread Marcel Molina

The friends_timeline will likely be around for an amount of time on
the scale of months, rather than weeks.

On Thu, Sep 3, 2009 at 3:03 AM, Rich wrote:
>
> Any idea how long the friends_timeline will be available for,
> obviously there might be some considerable development time assocated
> with switching (and in the case of iPhone applications getting Apple
> to review the whole process too!)
>
> On Sep 3, 1:19 am, Marcel Molina  wrote:
>> The current friends_timeline and home_timeline both include mentions
>> already. The friends_timeline will continue to not include retweets
>> since the payload for a retweeted status is slightly different. At
>> some future time, though, the friends_timeline will be removed in
>> favor of the home_timeline, which will include retweets. Having both
>> parallel timelines, with one that does not include retweets is just a
>> stop gap measure to ease the upgrade path.
>>
>>
>>
>> On Wed, Sep 2, 2009 at 4:56 PM, TjL wrote:
>>
>> > from the API page
>>
>> >> Twitter REST API Method: statuses/home_timeline [COMING SOON]
>> >> Returns the 20 most recent statuses, including retweets, posted by the 
>> >> authenticating user and that user's friends. This is the equivalent of 
>> >> /timeline/home on the Web.
>>
>> >> Usage note: This home_timeline is identical to statuses/friends_timeline 
>> >> except it also contains retweets, which statuses/friends_timeline does 
>> >> not (for backwards compatibility reasons). In a future version of the 
>> >> API, statuses/friends_timeline will go away and be replaced by 
>> >> home_timeline.
>>
>> > Does this mean that "in a future version of the API" there won't be
>> > any way to get a friends timeline without retweets?
>>
>> > Because the ability to ignore retweets ought to be a Day 1 feature, IMO.
>>
>> > I would put a much higher value on a unified feed which includes
>> > "*mentions* and friends" than "*retweets* and friends"
>>
>> > FWIW
>>
>> > TjL
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Draft: Twitter Rules for API Use

2009-09-10 Thread Marcel Molina

To accompany our updated Terms of Service (http://bit.ly/2ZXsyW) we've
posted a draft of the Twitter API rules at
http://twitter.com/apirules. As the subject states, these rules are a
work in progress and feedback is welcome. Please read the TOS
announcement at http://bit.ly/2ZXsyW for some background. We encourage
you to use the "contact us" link at http://twitter.com/apirules with
any feedback you may have.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Update on the Retweet API (we collapse retweets, not you & we're adding statuses/retweets)

2009-09-18 Thread Marcel Molina

The Retweet API launch is close at hand. You might have already seen
some retweets appearing in the new statuses/home_timeline from people
who've been testing them out. We've gotten lots of great questions and
feedback about the retweet API. Thanks to everyone who has rolled up
their sleeves and gotten involved. It's been a big help.

One of the main confusions and criticisms about the retweet API was
around what happens when a given tweet is retweeted multiple times.
The explanation was that developers need to do their own retweet
collapsing. If N people retweet a given tweet, you'd get N instances
of that same tweet in the appropriate retweet timeline and the home
timeline. You would then have to do your own internal book keeping
about whether that tweet had already come in. If it hadn't you'd
display it for the first time. If it had you'd update the already
displayed tweet.

Asking developers to collapse retweets in timelines is onerous,
complicated and confusing. We're not going to do it that way. We are
going to add a resource that gives you all retweets for a given tweet.
In timelines you will get only the first retweet. You can then request
all retweets for that tweet at any time to get up to 100 retweets that
have been created for it.

Here is the documentation for the new resource, statuses/retweets:
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweets

Sincere apologies if you've already written collapsing logic for
retweets. Beta releases are beta releases and I think the retweet API
is a lot better without the onerous collapsing requirement.

To give you some ideas of how you can use the API to display retweets,
here is a recent mock up of one of the potential UIs for the retweets
timeline on twitter.com:
http://a1.twimg.com/example-retweet-ui-18-sep-09.png

If you've got questions, find bugs, or have any kind of feedback, get
in touch via the dev mailing list, send an @reply to @twitterapi or
jump into the #twitterapi IRC channel on irc.freenode.net.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Deleting a Retweeted Tweet

2009-09-21 Thread Marcel Molina

If the original retweet is deleted its retweets will also disappear.

On Sun, Sep 20, 2009 at 3:56 PM, Dewald Pretorius  wrote:
>
> With the new retweeting, what happens with retweets if the original
> tweet is deleted, or the author's account is closed or suspended?
>
> Do all the retweets of that tweet also just disappear with it?
>
> Dewald
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Updates to the retweet API payload

2009-09-30 Thread Marcel Molina

We've updated the retweet payload to look a lot more like a regular
tweet's payload. We find this change makes the retweet API
conceptually simpler, easier and more convenient to work with and
better overall. I've linked to examples of the new payload below, and
will be updating documentation shortly, but first I'd like to share
some background on what we've learned working on the retweet API over
the past few weeks.

One of the big objectives of the retweet feature is discovering new
users to follow. We wanted the original status and its author
highlighted front and center so they get due credit for the tweet
someone you follow found worthy of retweeting. To that end the API was
designed to emphasize the original tweet by having it be the top level
object. Embedded within it we provided details about who retweeted it
and when.

Though this makes a statement to how we'd like the feature to be
thought about, logistically it doesn't degrade gracefully for clients
who don't implement any retweet logic in their code. Tweets appear in
timelines from people who you do not follow and unless clients
differentiate those tweets visually letting you know that someone you
follow has shared this tweet, confusion ensues.

To mitigate this, we opted to not include retweets into the existing
friends timeline. Instead we created a new parallel home timeline that
would be just like the friends timeline but included retweets. That
way developers could opt in to the retweet feature at their leisure.
Even with this opt in policy, though, there is still a critical
responsibility imposed on developers to clearly communicate to their
users that a given tweet in their timeline is a retweet and who the
retweet is from. The likelihood that confusion would result turned out
to be too high.

Additionally, with the original status as the top level object in the
payload, that means consumers of the API would receive what appears to
be the same tweet multiple times. In a lot of cases that's fine, in
others it's problematic.

After experimenting with this approach we've decided that it's a
better bet to craft a payload that will degrade far more gracefully.
So we've redesigned the retweet payload. Rather than having the
original tweet as the top level status with embedded details about who
retweeted it, the retweet is the top level object and within it we
include the original tweet and its author. You'll have full access to
the entire retweeted status and user as well as the original tweet and
its user. So you don't have to make any additional API calls and
should have everything you need to display a retweet distinctively
with attribute to both the original author and the retweeter. In other
words, these retweeted statuses look a whole lot like regular
statuses. This new design was our instinct to begin with and we
probably should have gone with it. We think it's better and hope you
do too. All the same documented resources will exist. Only the
payloads change.

The following timeline should contain examples of the updated retweet
payload. You can use this to test consuming retweets.
curl http://twitter.com/statuses/user_timeline/testiverse.xml
curl http://twitter.com/statuses/user_timeline/testiverse.json

In the event that new tweets go into the above timeline that push the
retweets out, you can access a few directly at the following urls:
curl http://twitter.com/statuses/show/4452134416.xml
curl http://twitter.com/statuses/show/4452466408.xml
curl http://twitter.com/statuses/show/4349744308.xml

The above payloads don't contain a "retweet_count" element yet and
they probably will. Other than that we don't suspect any more major
changes as we approach a full public launch. As always, though, we're
open and solicitous of everyone's feedback.

Thanks.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] New Twitter feature & API coming soon: Lists

2009-09-30 Thread Marcel Molina

Over on the main Twitter blog @nk has written about a new Lists
feature we're getting ready to launch:
http://blog.twitter.com/2009/09/soon-to-launch-lists.html. We just
wanted to let API developers know that we'll be shipping an API for it
on day one. You'll be able to do things like create lists, add and
remove users from lists, find out who has been added to a list and
read the tweet timeline for a given list.

Stay tuned for documentations on the full Lists API soon.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Multiple language support for your Twitter application

2009-10-08 Thread Marcel Molina

Over on the main Twitter blog we've just announced that we'll be
translating the site into French, Italian, Spanish and German soon,
with more languages to come later (http://bit.ly/LIa4C). We figured a
lot of folks building apps on the Twitter Platform might be interested
in providing their applications in various languages too but haven't
had the time or resources to take on building up full translations. So
we are planning to provide our translation files to the developer
community. We hope they're useful as at least a starting point for
your own.

We're just getting started. We'll follow up with more details about
where you'll be able to get these translations soon.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] New spam reporting API now available

2009-10-14 Thread Marcel Molina

On the heels of adding a "Report as spam" button to twitter.com
(http://blog.twitter.com/2009/10/help-us-nail-spammers.html), you can
now also simultaneously block and report a user as a spammer via the
API.

The documentation for the report_spam resource can be found here:
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-report_spam

As the original announcement mentions, it's important to realize no
automated action will be taken as a result of a spam report being
created. So don't expect an account to be suspended immediately (or at
all). Also you can only create one spam report for a given user, so
subsequent requests will have no result.

Thanks.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Seeing retweeted_details for user_timeline payload

2009-10-15 Thread Marcel Molina

Having retweets in the user_timeline isn't intentional. I'll be
ensuring they don't appear there in the next few days. The only place
they should be appearing (once publicly available) is the
home_timeline.

On Wed, Oct 14, 2009 at 7:45 PM, Martin  wrote:
>
> I'm retrieving the timeline for a specific user:
>
> curl http://www.twitter.com/statuses/user_timeline/ev.xml
>
> Within that timeline, I see retweeted_status fragment.
> Is this normal behavior ?
>
> Thanks - Martin
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Seeing retweeted_details for user_timeline payload

2009-10-15 Thread Marcel Molina

Updating the retweet doc payloads is on my todo list. It's
unfortunately currently a tedious and onerous task. I've been using my
cycles on other things. But it's on the list to do.

On Thu, Oct 15, 2009 at 1:53 PM, Josh Roesslein  wrote:
>
> The API doc on the wiki is not correct. There was an email sent out
> earlier about the new payload
> format.
>
> Could someone update the wiki for the new payload?
>
> Josh
>
> On Thu, Oct 15, 2009 at 3:48 PM, Rich  wrote:
>>
>> Hmm except this API payload doesn't match that for the home_timeline
>>
>> Hometimeline shows retweet_status with a sub tag of retweeting_user,
>> but yet @ev's user timeline shows a tag of retweet_status with a
>> subtag of user.
>>
>> I want to support it but not with the inconsistency in the API
>>
>> On Oct 15, 5:18 pm, Martin  wrote:
>>> I have no problem with this new API call. But why is it also included
>>> in the user_timeline payload ?
>>> Is this inclusion official on the Twitter side...
>>>
>>> Martin
>>>
>>> On Oct 15, 9:46 am, ryan alford  wrote:
>>>
>>>
>>>
>>> >http://apiwiki.twitter.com/Twitter-REST-API-Method:-statuses-home_tim...
>>> > <http://apiwiki.twitter.com/Twitter-REST-API-Method:-statuses-home_tim...>That
>>> > will be the new "Friends Timeline".  It will include retweets, while the
>>> > current "Friends Timeline" will not.  The current "Friends Timeline" will
>>> > also be going away at some point in the future.
>>>
>>> > Ryan
>>>
>>> > On Thu, Oct 15, 2009 at 8:53 AM, Martin  wrote:
>>>
>>> > > Thanks for the clarification.
>>>
>>> > > That explains the inconsistent behavior we are seeing when trying to
>>> > > load specific user timelines.
>>> > > Do we have an updated api wiki that defines the semantics of the
>>> > >  fragment ?
>>>
>>> > > Martin
>>> > >www.wherecloud.com
>>>
>>> > > On Oct 14, 10:59 pm, Josh Roesslein  wrote:
>>> > > > I think its been enabled for a select few for testing. I don't think
>>> > > > its gone public yet.
>>>
>>> > > > On Wed, Oct 14, 2009 at 9:56 PM, ryan alford 
>>> > > wrote:
>>> > > > > Maybe the new retweet functionality has been turned on?
>>> > > > > Ryan
>>>
>>> > > > > On Wed, Oct 14, 2009 at 10:45 PM, Martin 
>>> > > wrote:
>>>
>>> > > > >> I'm retrieving the timeline for a specific user:
>>>
>>> > > > >> curlhttp://www.twitter.com/statuses/user_timeline/ev.xml
>>>
>>> > > > >> Within that timeline, I see retweeted_status fragment.
>>> > > > >> Is this normal behavior ?
>>>
>>> > > > >> Thanks - Martin
>>>
>>> > > > --
>>> > > > Josh
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Lists API

2009-10-15 Thread Marcel Molina

We are rolling it out to a small set of users incrementally so that we
can load test and find bugs. We've been working on the API
documentation and will be rolling it out gradually.

On Thu, Oct 15, 2009 at 4:10 PM, Eric Woodward  wrote:
>
> So, what is the plan for releasing the Lists API, if there is one? It
> is well known that selected people have access to them while the rest
> of us do not, which is creating a problem with users. Is there a plan
> to release these APIs to everyone soon?
>
> Please respond. I am only asking.
>
> --ejw
>
> Eric Woodward
> Email: e...@nambu.com
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Draft of List API documentation

2009-10-16 Thread Marcel Molina

Hey folks. As some of you have likely read we're starting to do some
private beta testing of our new lists feature. We're not quite ready
to open it up to everyone but we've made some headway on the API and
wanted to share some details of what we've got so far.

There are a handful of things on our todo lists so don't consider this
signed and sealed just yet.

You may notice this API is a bit of a departure from the rest of the
API. It's a bit more, errr, REST than the rest.

First off, here's the current payload for a list:



  1416
  tall people
  @noradio/tall-people
  tall-people
  0
  3
  /noradio/tall-people
  public
  
3191321
Marcel Molina
noradio
San Francisco, CA
Engineer at Twitter on the @twitterapi team, obsessed
with rock climbing & running. In a past life I was a member of the
Rails Core team.

http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_normal.jpg
http://project.ioni.st
false
40059
9AE4E8
33
0084B4
DDFFCC
BDDCAD
354
Mon Apr 02 07:47:28 + 2007
131
-28800
Pacific Time (US & Canada)

http://a1.twimg.com/profile_background_images/18156348/jessica_tiled.jpg.jpeg
true
3472
false
true
false
false
  


=== Lists ===

POST '/:user/lists.:format'
Creates a new list for the authenticated user.

Parameters:
 * name: the name of the list. (required)
 * mode: whether your list is public of private. Values can be
'public' or 'private'. Public by default if not specified. (optional)

Usage notes:
 ":user" in the url should be the screen name of the user making the
request to create the list

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD -d "name=tall people&mode=private"
http://twitter.com/noradio/lists.xml

POST/PUT '/:user/lists/:list_slug.:format'
Updates the specified list.

Takes the same parameters as the create resource at POST
'/:user/lists.:format' (:name and :mode).

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD -d "name=giants&mode=public"
http://twitter.com/noradio/lists/tall-people.xml

GET '/:user/lists.:format'
Lists your lists.

Supported format:
xml, json

e.g.
 curl -u USERNAME:PASSWORD http://twitter.com/noradio/lists.xml

GET '/:user/lists/memberships.:format'
List the lists the specified user has been added to.

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD http://twitter.com/noradio/lists/memberships.xml

DELETE '/:user/lists/:list_slug.:format'
Delete the specified list owned by the authenticated user.

Parameters:
 * list_slug: the slug of the list you want to delete. (required)

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD -X DELETE
http://twitter.com/noradio/lists/tall-people.xml

GET '/:users/lists/:list_slug/statuses.:format'
Show tweet timeline for members of the specified list.

Parameters:
 * list_slug: the slug of the list you want the member tweet timeline
of. (required)
 * next/previous_cursor: used to "page" through results (optional)

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD
http://twitter.com/noradio/lists/tall-people/statuses.xml

GET '/:users/lists/:list_slug.:format'
Show a specific list you can use the new resource.

Supported formats:
xml, json

e.g.
  curl -u USERNAME:PASSWORD http://twitter.com/noradio/lists/tall-people.xml

=== List members ===

POST '/:user/:list_slug/members.:format'
Add a member to a list.

Parameters:
 * id: the id of the user you want to add as a member to the list. (required)

Usage notes:
The :list_slug portion of the request path should be the slug of the
list you want to add a member to.

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD -d "id=123456789"
http://http://twitter.com/noradio/tall-people/members.xml

GET '/:user/:list_slug/members.:format'
Members of the specified list.

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD http://twitter.com/noradio/tall-people/members.xml

DELETE '/:user/:list_slug/members.:format'
Remove a member from the specified list.

Parameters:
 * id: the id of the user you want to remove as a member from the
list. (required)

Usage notes:
The :list_id portion of the request path should be the slug of the
list you want to add a member to.

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD -X DELETE -d "id=123456789"
http://twitter.com/noradio/tall-people/members.xml

GET '/:user/:list_slug/members/:id.:format'
Check if a user is a member of the specified list.

Usage notes:
The :id is the id of the user you're inquiring about.

Supported formats:
xml, json

e.g.
 curl -u USERNAME:PASSWORD
http://twitter.com/noradio/tall-people/members/123456789.xml

=== List subscribers ===

POST '/:user/:l

[twitter-dev] Laying the foundation for API versioning

2009-10-16 Thread Marcel Molina

We've taken the first steps toward introducing versioning into the
Twitter REST API. With a versioned API we can make ambitious
improvements *today*, not tomorrow, without worrying about breaking
backwards compatibility. This will lead to both a better and more
reliable API.

Available right now, the API's new home is at http://api.twitter.com.
Currently only one version is supported: version 1 :-) Version 1
should be in all ways functionally equivalent to the API you're using
at the main twitter.com url (if you find what seems like an
incompatibility please submit what you've found on our issue tracker:
http://code.google.com/p/twitter-api/issues/list).

To make a request with the new versioned API, you just need to prefix
every path with the desired version. For now that's just 1.

So for example, what was

http://twitter.com/users/show/noradio.xml

becomes

http://api.twitter.com/1/users/show/noradio.xml

For now we're keeping it simple. No subversions, no implicit version
defaults, no fancy-pants etc. We're leaving our approach open to these
types of additions, but we aren't going to support them until we feel
a compelling need to.

We haven't yet determined how many versions will be supported at once
or how long a version will continue to be supported once it's
deprecated. We'll be figuring out answers to these questions once we
spend some time supporting multiple versions and seeing how new APIs
emerge and iterate. We suspect though that we'll support deprecated
versions for at least 6 months.

We also don't have a hard date for when API requests to
http://twitter.com will no longer be serviced. We aren't planning on
pulling the rug out from anyone though. Please update your
applications to the new http://api.twitter.com/1 at your soonest
convenience. The non API urls likely won't be supported forever.

Though having a versioned API should greatly decrease the likelihood
that a change in the API breaks your application, one of the notable
exceptions is bug fixes. When bugs are discovered they will be fixed
and backported immediately to all supported versions of the API.

We're kicking the tires on http://api.twitter.com/1 but we hope to
have http://api.twitter.com/2 close around the corner. The time has
come for us to start knocking off some of the stuff on V2 Roadmap list
http://apiwiki.twitter.com/V2-Roadmap. For a while that page has been
the dumping ground for all our lofty dreams. Version 2 probably won't
be so ambitious that it resolves everything on that list. We want,
after all, to get good at managing a multi-version environment before
we get all crazy with the nitrous injections and chrome detailing. But
we're putting the framework in place that will allow us to more
quickly fix the stuff you've struggling with, take chances without
putting your work in jeopardy, and all other things that are good.

Cheers.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Laying the foundation for API versioning

2009-10-16 Thread Marcel Molina

The OAuth endpoints aren't strictly speaking part of the REST API.

http://api.twitter.com/oauth/authorize and family works at the api
subdomain, but those paths aren't versioned (though maybe they should
be...). As for search...one step at a time ;-) But thanks for
noticing.

On Fri, Oct 16, 2009 at 12:46 AM, Rich  wrote:
>
> Great news guys, I noticed that the search and oauth API's aren't in
> the version one API stream though.
>
> Is this intentional?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Laying the foundation for API versioning

2009-10-16 Thread Marcel Molina

I've alerted our ops team. Thanks for the heads up.

On Fri, Oct 16, 2009 at 12:56 AM, Rich  wrote:
>
> I did notice though that api.twitter.com doesn't have a valid SSL
> certificate so any clients using the API over SSL will error out too.
>
> On Oct 16, 8:49 am, Marcel Molina  wrote:
>> The OAuth endpoints aren't strictly speaking part of the REST API.
>>
>> http://api.twitter.com/oauth/authorizeand family works at the api
>> subdomain, but those paths aren't versioned (though maybe they should
>> be...). As for search...one step at a time ;-) But thanks for
>> noticing.
>>
>> On Fri, Oct 16, 2009 at 12:46 AM, Rich  wrote:
>>
>> > Great news guys, I noticed that the search and oauth API's aren't in
>> > the version one API stream though.
>>
>> > Is this intentional?
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Draft of List API documentation

2009-10-16 Thread Marcel Molina

Depending on how our performance tests, bug fixes and all the other
myriad things go we could be public with the feature as early as a
week or two from now. We shall see...

On Fri, Oct 16, 2009 at 1:06 AM, Rich  wrote:
>
> This is fantastic, I hope to start working on it soon.  Do you guys
> have and idea of possible timespans, only because it takes us two
> weeks to get things past Apple's appoval process!
>
> On Oct 16, 8:04 am, Marcel Molina  wrote:
>> Hey folks. As some of you have likely read we're starting to do some
>> private beta testing of our new lists feature. We're not quite ready
>> to open it up to everyone but we've made some headway on the API and
>> wanted to share some details of what we've got so far.
>>
>> There are a handful of things on our todo lists so don't consider this
>> signed and sealed just yet.
>>
>> You may notice this API is a bit of a departure from the rest of the
>> API. It's a bit more, errr, REST than the rest.
>>
>> First off, here's the current payload for a list:
>>
>> 
>> 
>>   1416
>>   tall people
>>   @noradio/tall-people
>>   tall-people
>>   0
>>   3
>>   /noradio/tall-people
>>   public
>>   
>>     3191321
>>     Marcel Molina
>>     noradio
>>     San Francisco, CA
>>     Engineer at Twitter on the @twitterapi team, obsessed
>> with rock climbing & running. In a past life I was a member of the
>> Rails Core team.
>>     
>> http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_no...
>>     http://project.ioni.st
>>     false
>>     40059
>>     9AE4E8
>>     33
>>     0084B4
>>     DDFFCC
>>     BDDCAD
>>     354
>>     Mon Apr 02 07:47:28 + 2007
>>     131
>>     -28800
>>     Pacific Time (US & Canada)
>>     
>> http://a1.twimg.com/profile_background_images/18156348/jessica_tiled
>>     true
>>     3472
>>     false
>>     true
>>     false
>>     false
>>   
>> 
>>
>> === Lists ===
>>
>> POST '/:user/lists.:format'
>> Creates a new list for the authenticated user.
>>
>> Parameters:
>>  * name: the name of the list. (required)
>>  * mode: whether your list is public of private. Values can be
>> 'public' or 'private'. Public by default if not specified. (optional)
>>
>> Usage notes:
>>  ":user" in the url should be the screen name of the user making the
>> request to create the list
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -d "name=tall 
>> people&mode=private"http://twitter.com/noradio/lists.xml
>>
>> POST/PUT '/:user/lists/:list_slug.:format'
>> Updates the specified list.
>>
>> Takes the same parameters as the create resource at POST
>> '/:user/lists.:format' (:name and :mode).
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -d 
>> "name=giants&mode=public"http://twitter.com/noradio/lists/tall-people.xml
>>
>> GET '/:user/lists.:format'
>> Lists your lists.
>>
>> Supported format:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORDhttp://twitter.com/noradio/lists.xml
>>
>> GET '/:user/lists/memberships.:format'
>> List the lists the specified user has been added to.
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORDhttp://twitter.com/noradio/lists/memberships.xml
>>
>> DELETE '/:user/lists/:list_slug.:format'
>> Delete the specified list owned by the authenticated user.
>>
>> Parameters:
>>  * list_slug: the slug of the list you want to delete. (required)
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -X 
>> DELETEhttp://twitter.com/noradio/lists/tall-people.xml
>>
>> GET '/:users/lists/:list_slug/statuses.:format'
>> Show tweet timeline for members of the specified list.
>>
>> Parameters:
>>  * list_slug: the slug of the list you want the member tweet timeline
>> of. (required)
>>  * next/previous_cursor: used to "page" through results (optional)
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u 
>> USERNAME:PASSWORDhttp://twitter.com/noradio/lists/tall-people/status

[twitter-dev] Re: Laying the foundation for API versioning

2009-10-16 Thread Marcel Molina

Thanks for the report. Looking into it.

On Fri, Oct 16, 2009 at 12:55 PM, Dave Briccetti  wrote:
>
> DELETE http://twitter.com/friendships/destroy/USER.xml
>
> works, but
>
> DELETE http://api.twitter.com/1/friendships/destroy/USER.xml
>
> fails with
>
> You don't have permission to access /1/friendships/destroy/USER.xmlon
> this server.
>
>
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Laying the foundation for API versioning

2009-10-16 Thread Marcel Molina

This was an oversight in a server configuration. We've made the change
and should be pushing it out at some point today. Thanks again.

On Fri, Oct 16, 2009 at 12:55 PM, Dave Briccetti  wrote:
>
> DELETE http://twitter.com/friendships/destroy/USER.xml
>
> works, but
>
> DELETE http://api.twitter.com/1/friendships/destroy/USER.xml
>
> fails with
>
> You don't have permission to access /1/friendships/destroy/USER.xmlon
> this server.
>
>
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Laying the foundation for API versioning

2009-10-18 Thread Marcel Molina

The change has been made but it probably hasn't been pushed out yet to
the full cluster. I'll follow up with ops on Monday. Thanks.

On Sun, Oct 18, 2009 at 1:10 PM, Dave Briccetti  wrote:
>
> Thanks, but still failing today.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Private lists showing up on memberships page

2009-10-19 Thread Marcel Molina

That looks like a bug. Thanks for bringing it to our attention.

On Sun, Oct 18, 2009 at 1:49 PM, Damon C  wrote:
>
> I've seen a couple instances now (@beaker and @mediaphyter) where a
> private list shows up on the list of a user's memberships. It doesn't
> seem like the existence of these private lists should be showing up in
> the memberships list, nor can I reproduce the issue on my own account.
> As an example, here's a brief snippet from 
> http://twitter.com/Beaker/lists/memberships.xml
> (sidenote that the member_count shows up as 5 on the HTML version of
> the memberships page).
>
> 
> 19351
> Security
> @twowheelgeek/security
> security
> 0
> 0
> /twowheelgeek/security
> private
>
> dpc
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Draft of List API documentation

2009-10-21 Thread Marcel Molina

There are plans to expose a description field eventually.

On Wed, Oct 21, 2009 at 9:59 AM, nipunj  wrote:
>
> Hey Marcel,
> I expect there were many things cut in Lists v1,... but, that said, I
> am surprised that Title is essentially the only attribute on the List
> object that informs the consumer what a Public List is intended to
> actually represent. There's no "bio" analog. IMO, this lack of
> explicit descriptive attributes hamstrings Lists discovery. How about
> "tags", "description", "list type", etc.?
>
> Also,... I understand your need to test out the API right now, but
> you've created inequity with the private API access. How can folks
> like us, who have an app that's closely related to Lists, get access
> to the Lists API (ie create a level playing field)?
>
> Thanks,
> Nipun
>
> @nipj
> @tweeppacks
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Laying the foundation for API versioning

2009-10-21 Thread Marcel Molina

Ops is working on fixing this. We identified some stale configurations
on some hosts (which is why the failures are intermittent). It's
currently being worked on and should be resolved soon. Thanks for
reporting it.

On Wed, Oct 21, 2009 at 10:00 AM, Sal Conigliaro  wrote:
>
> Hi Marcel-
>
> I'm still seeing the cert hostname mismatch.
>
> https://api.twitter.com/1/users/show/rwzombie.xml
>
> The cert hostname returned is still shown as 'twitter.com'.
>
> Sal
>
> On Oct 18, 4:36 pm, Marcel Molina  wrote:
>> The change has been made but it probably hasn't been pushed out yet to
>> the full cluster. I'll follow up with ops on Monday. Thanks.
>>
>> On Sun, Oct 18, 2009 at 1:10 PM, Dave Briccetti  wrote:
>>
>> > Thanks, but still failing today.
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Not cool to RT a protected tweet

2009-10-22 Thread Marcel Molina

Protected tweets will not be retweetable.

On Thu, Oct 22, 2009 at 11:42 AM, Tim Haines  wrote:
>
> Hey guys,
>
> @ev: "It's not cool to RT a protected tweet"  
> http://twitter.com/ev/status/4955618846
>
> Will the new RT api disallow you from RT'ing protected tweets?  I
> think this would be a good move.
>
> Tim.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Updates to the List API (list descriptions, cursoring lists of lists, finding by list id rather than slug & more consistent names)

2009-10-28 Thread Marcel Molina

Two additions and two changes to the List API will be deployed in the
next few days:

* List descriptions
We're adding a description to every list. You'll be able to specify a
description when you create or update a list and the description will
be included in the payload.

* Cursoring through lists of lists
All resources that return a list of lists will include next and
previous cursors and will accept a :cursor parameter.

* Finding by list id rather than slug
When you change the name of a list, the slug will be updated to
reflect that change. That means using the slug in the url for
resources to operate on lists requires the onerous task of validating
that the slug for the list you are about to do something with hasn't
been updated since the last time you stored its slug. What a nightmare
:-)

Every list also has an id. This value won't change. We'll be changing
the API to replace all instances of a list slug in urls to be list ids
instead.

* Consistent names
The terminology we've used thus far for people you follow with a list
is members. The terminology for people who are following a list is
subscribers. We're going to mirror the terminology used for users and
change it to followers and following respectively.

So:

/:user/lists/:list_id/memberships becomes /:user/lists/:list_id/followers

/:user/lists/:list_id/subscribers becomes /:user/lists/:list_id/following

As we deploy these changes we'll send out a heads up on the dev list
and @twitterapi.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Updates to the List API (list descriptions, cursoring lists of lists, finding by list id rather than slug & more consistent names)

2009-10-28 Thread Marcel Molina

Answers inline:

On Wed, Oct 28, 2009 at 1:14 PM, Tim Haines  wrote:
>
> Marcel,
>
> Great changes.  A couple of questions:
>
> - How long can a list description be?

160 :-)

> - A title can only be 15 chars - will that remain unchanged?

Unchanged.

> - Will there be a little overlap where memberships and subscribers
> will still work while people migrate to followers/following?

Yeah. There will be overlap for some period of time for those who
might need to transition.

> It would be awesome if there was a way to retrieve all member ids and
> a separate call for subscriber ids - cursored if necessary.

Right, I'll add that to the "list of things to consider" :-)

> Also, filed an edge case bug around list error messages a couple of
> days ago.
> http://code.google.com/p/twitter-api/issues/detail?id=1145&sort=-opened&colspec=ID%20Stars%20Type%20Status%20Priority%20Owner%20Summary%20Opened%20Modified%20Component

Thanks.

> Cheers,
>
> Tim.
>
>
> On Oct 29, 9:00 am, Marcel Molina  wrote:
>> Two additions and two changes to the List API will be deployed in the
>> next few days:
>>
>> * List descriptions
>> We're adding a description to every list. You'll be able to specify a
>> description when you create or update a list and the description will
>> be included in the payload.
>>
>> * Cursoring through lists of lists
>> All resources that return a list of lists will include next and
>> previous cursors and will accept a :cursor parameter.
>>
>> * Finding by list id rather than slug
>> When you change the name of a list, the slug will be updated to
>> reflect that change. That means using the slug in the url for
>> resources to operate on lists requires the onerous task of validating
>> that the slug for the list you are about to do something with hasn't
>> been updated since the last time you stored its slug. What a nightmare
>> :-)
>>
>> Every list also has an id. This value won't change. We'll be changing
>> the API to replace all instances of a list slug in urls to be list ids
>> instead.
>>
>> * Consistent names
>> The terminology we've used thus far for people you follow with a list
>> is members. The terminology for people who are following a list is
>> subscribers. We're going to mirror the terminology used for users and
>> change it to followers and following respectively.
>>
>> So:
>>
>> /:user/lists/:list_id/memberships becomes /:user/lists/:list_id/followers
>>
>> /:user/lists/:list_id/subscribers becomes /:user/lists/:list_id/following
>>
>> As we deploy these changes we'll send out a heads up on the dev list
>> and @twitterapi.
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Updates to the List API (list descriptions, cursoring lists of lists, finding by list id rather than slug & more consistent names)

2009-10-28 Thread Marcel Molina

Real soon now. We appreciate everyone's patience while we gradually
ramp up traffic to lists to ensure we've got all our ducks in a row.

On Wed, Oct 28, 2009 at 2:53 PM, Rich  wrote:
>
> +1 to this
>
> Any news on when the rest of us devs can get access to this to work on
> our apps?
>
> On Oct 28, 8:11 pm, Jesse Stay  wrote:
>> Maybe a little more appropriate to post this to a private list (no pun
>> intended) for beta users?  I admit I feel a little jealous every time I see
>> one of these updates, unless there's some way to get into the beta.
>>
>> Thanks,
>>
>> Jesse
>>
>>
>>
>> On Wed, Oct 28, 2009 at 2:00 PM, Marcel Molina  wrote:
>>
>> > Two additions and two changes to the List API will be deployed in the
>> > next few days:
>>
>> > * List descriptions
>> > We're adding a description to every list. You'll be able to specify a
>> > description when you create or update a list and the description will
>> > be included in the payload.
>>
>> > * Cursoring through lists of lists
>> > All resources that return a list of lists will include next and
>> > previous cursors and will accept a :cursor parameter.
>>
>> > * Finding by list id rather than slug
>> > When you change the name of a list, the slug will be updated to
>> > reflect that change. That means using the slug in the url for
>> > resources to operate on lists requires the onerous task of validating
>> > that the slug for the list you are about to do something with hasn't
>> > been updated since the last time you stored its slug. What a nightmare
>> > :-)
>>
>> > Every list also has an id. This value won't change. We'll be changing
>> > the API to replace all instances of a list slug in urls to be list ids
>> > instead.
>>
>> > * Consistent names
>> > The terminology we've used thus far for people you follow with a list
>> > is members. The terminology for people who are following a list is
>> > subscribers. We're going to mirror the terminology used for users and
>> > change it to followers and following respectively.
>>
>> > So:
>>
>> > /:user/lists/:list_id/memberships becomes /:user/lists/:list_id/followers
>>
>> > /:user/lists/:list_id/subscribers becomes /:user/lists/:list_id/following
>>
>> > As we deploy these changes we'll send out a heads up on the dev list
>> > and @twitterapi.
>>
>> > --
>> > Marcel Molina
>> > Twitter Platform Team
>> >http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Updates to the List API (list descriptions, cursoring lists of lists, finding by list id rather than slug & more consistent names)

2009-10-28 Thread Marcel Molina

The cursors are for lists of lists and lists of users followed
by/following lists. The statuses timeline for a given list takes all
the same options you'd expect to manage status timelines.

On Wed, Oct 28, 2009 at 5:43 PM, Naveen  wrote:
>
> How does one keep a list up to date for a client without the concept
> of since_id, like we have for the timeline methods? I look at a lists
> as just a different timeline (granted one filtered to specific users),
> but that is how I would expect to view them in a client.
>
> From my understanding of cursors, on each request we have to start at
> -1 (to start paging) and page until we find an id that we already have
> locally. While this will work, it has a high probability of always
> over requesting data..
>
> So if I have a list with two people in it, and they only tweet once a
> week, when I poll for updates of this list (say every 30min)  the data
> is going to be the same most of the time(last 100 messages that these
> two people post). This seems like a waste of bandwidth for Twitter and
> us.. Some may argue that bandwidth is cheap, but it really is not on
> mobile devices. Some carriers charge per kb, but even on unlimited
> plans every byte transferred translates to additional battery drain..
>
> Is there some concept of the cursor that I am not understanding that
> will allow us to also filter based on something like since_id? So we
> want to get messages newer than we already have and notify the user
> that the list has something new to display.
>
> Thanks to anyone who can clarify if I am misunderstanding something.
>
> --Naveen
>
> On Oct 28, 6:14 pm, Marcel Molina  wrote:
>> Real soon now. We appreciate everyone's patience while we gradually
>> ramp up traffic to lists to ensure we've got all our ducks in a row.
>>
>>
>>
>>
>>
>> On Wed, Oct 28, 2009 at 2:53 PM, Rich  wrote:
>>
>> > +1 to this
>>
>> > Any news on when the rest of us devs can get access to this to work on
>> > our apps?
>>
>> > On Oct 28, 8:11 pm, Jesse Stay  wrote:
>> >> Maybe a little more appropriate to post this to a private list (no pun
>> >> intended) for beta users?  I admit I feel a little jealous every time I 
>> >> see
>> >> one of these updates, unless there's some way to get into the beta.
>>
>> >> Thanks,
>>
>> >> Jesse
>>
>> >> On Wed, Oct 28, 2009 at 2:00 PM, Marcel Molina  wrote:
>>
>> >> > Two additions and two changes to the List API will be deployed in the
>> >> > next few days:
>>
>> >> > * List descriptions
>> >> > We're adding a description to every list. You'll be able to specify a
>> >> > description when you create or update a list and the description will
>> >> > be included in the payload.
>>
>> >> > * Cursoring through lists of lists
>> >> > All resources that return a list of lists will include next and
>> >> > previous cursors and will accept a :cursor parameter.
>>
>> >> > * Finding by list id rather than slug
>> >> > When you change the name of a list, the slug will be updated to
>> >> > reflect that change. That means using the slug in the url for
>> >> > resources to operate on lists requires the onerous task of validating
>> >> > that the slug for the list you are about to do something with hasn't
>> >> > been updated since the last time you stored its slug. What a nightmare
>> >> > :-)
>>
>> >> > Every list also has an id. This value won't change. We'll be changing
>> >> > the API to replace all instances of a list slug in urls to be list ids
>> >> > instead.
>>
>> >> > * Consistent names
>> >> > The terminology we've used thus far for people you follow with a list
>> >> > is members. The terminology for people who are following a list is
>> >> > subscribers. We're going to mirror the terminology used for users and
>> >> > change it to followers and following respectively.
>>
>> >> > So:
>>
>> >> > /:user/lists/:list_id/memberships becomes 
>> >> > /:user/lists/:list_id/followers
>>
>> >> > /:user/lists/:list_id/subscribers becomes 
>> >> > /:user/lists/:list_id/following
>>
>> >> > As we deploy these changes we'll send out a heads up on the dev list
>> >> > and @twitterapi.
>>
>> >> > --
>> >> > Marcel Molina
>> >> > Twitter Platform Team
>> >> >http://twitter.com/noradio
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Subscribed Lists

2009-11-01 Thread Marcel Molina

Currently it's still slug. It hasn't been updated yet. When it is
updated it will for some period of transition accept a slug or an id
but eventually support for the slug in the url will be removed
entirely.

On Sun, Nov 1, 2009 at 2:14 AM, Rich  wrote:
>
> Can we get some form of confirmation on the list slug/id issue.  At
> the moment calling by ID doesn't work anyway so it's only using the
> slug.
>
> My preference would be to allow either (in a similar way to the other
> REST api's where you can use user id or screenName)
>
> On Oct 31, 10:04 pm, twittelator  wrote:
>> :user/lists/subscriptions.:format
>>
>> gets the lists that the user has subscribed to.
>>
>> Andrew Stone
>> Twitter / @twittelatorhttp://www.stone.com
>> got iPhone?
>>        http://tinyurl.com/twitpro
>>        http://tinyurl.com/intentionizer
>>        http://tinyurl.com/gesture-buy
>>        http://tinyurl.com/igraffiti
>>        http://tinyurl.com/talkingpics
>>        http://tinyurl.com/mobilemix
>>        http://tinyurl.com/soundbite
>>        http://tinyurl.com/icreated
>>        http://tinyurl.com/pulsar-app
>>
>> On Oct 30, 5:00 am, "David Neubauer" 
>> wrote:
>>
>>
>>
>> > Has any figured out how to get a the lists I'm subscribed to. I didn't
>> > realize how much I'd want this part of it. Please say it's coming...
>>
>> > -Original Message-
>> > From: twitter-development-talk@googlegroups.com
>>
>> > [mailto:twitter-development-t...@googlegroups.com] On Behalf Of Jeremy Felt
>> > Sent: Thursday, October 29, 2009 8:16 PM
>> > To: Twitter Development Talk
>> > Subject: [twitter-dev] Re: Updates to the List API (list descriptions,
>> > cursoring lists of lists, finding by list id rather than slug & more
>> > consistent names)
>>
>> > It appears that user/lists.xml only shows lists that are created by
>> > the user and not those that they follow.
>>
>> > Any change coming to that or am I missing a way to see all lists that
>> > a user follows?
>>
>> > Thanks,
>> > Jeremy
>>
>> > On Oct 28, 3:00 pm, Marcel Molina  wrote:
>> > > Two additions and two changes to the List API will be deployed in the
>> > > next few days:
>>
>> > > * List descriptions
>> > > We're adding a description to every list. You'll be able to specify a
>> > > description when you create or update a list and the description will
>> > > be included in the payload.
>>
>> > > * Cursoring through lists of lists
>> > > All resources that return a list of lists will include next and
>> > > previous cursors and will accept a :cursor parameter.
>>
>> > > * Finding by list id rather than slug
>> > > When you change the name of a list, the slug will be updated to
>> > > reflect that change. That means using the slug in the url for
>> > > resources to operate on lists requires the onerous task of validating
>> > > that the slug for the list you are about to do something with hasn't
>> > > been updated since the last time you stored its slug. What a nightmare
>> > > :-)
>>
>> > > Every list also has an id. This value won't change. We'll be changing
>> > > the API to replace all instances of a list slug in urls to be list ids
>> > > instead.
>>
>> > > * Consistent names
>> > > The terminology we've used thus far for people you follow with a list
>> > > is members. The terminology for people who are following a list is
>> > > subscribers. We're going to mirror the terminology used for users and
>> > > change it to followers and following respectively.
>>
>> > > So:
>>
>> > > /:user/lists/:list_id/memberships becomes /:user/lists/:list_id/followers
>>
>> > > /:user/lists/:list_id/subscribers becomes /:user/lists/:list_id/following
>>
>> > > As we deploy these changes we'll send out a heads up on the dev list
>> > > and @twitterapi.
>>
>> > > --
>> > > Marcel Molina
>> > > Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: how to create list of lists

2009-11-01 Thread Marcel Molina

This is probably confusion arising from something I wrote in a
previous email. When I said "list of list" I meant the payload of the
response body had zero or more list elements in it, therefore a "list
of lists". There is no way to create lists of lists in the sense that
you are talking about.

On Sat, Oct 31, 2009 at 7:13 AM, Ravi  wrote:
>
>
> The new api talks about list of lists. I do not see how to add a list
> to another list. Whenever I follow a list, my main account follows it,
> not my list.
>
> On a side note, I was playing with the API yesterday and somehow a
> list I created shows up twice under "Lists you follow". I guess a bug
> somewhere.
>
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Subscribed Lists

2009-11-01 Thread Marcel Molina

Resolving a @screen_name/list_name reference in a tweet is a
compelling argument for making the url parameter polymorphic and not
deprecating the use of slugs. I will cogitate.

On Sun, Nov 1, 2009 at 10:09 AM,   wrote:
> I have to second Rich on this - ID-only is flawed, as twitter supports 
> hotlinking lists by name (@username/slug) in tweets, and links that to the 
> list page. If clients want to offer the same behavior, this is not possible 
> if the API only supports IDs (or would require a potentially large number of 
> additional requests to get the user's lists and page through them to find the 
> one mentioned).
>
> Marco
> 
>
> -----Original Message-
> From: Marcel Molina 
> Date: Sun, 1 Nov 2009 10:02:31
> To: 
> Subject: [twitter-dev] Re: Subscribed Lists
>
>
> Currently it's still slug. It hasn't been updated yet. When it is
> updated it will for some period of transition accept a slug or an id
> but eventually support for the slug in the url will be removed
> entirely.
>
> On Sun, Nov 1, 2009 at 2:14 AM, Rich  wrote:
>>
>> Can we get some form of confirmation on the list slug/id issue.  At
>> the moment calling by ID doesn't work anyway so it's only using the
>> slug.
>>
>> My preference would be to allow either (in a similar way to the other
>> REST api's where you can use user id or screenName)
>>
>> On Oct 31, 10:04 pm, twittelator  wrote:
>>> :user/lists/subscriptions.:format
>>>
>>> gets the lists that the user has subscribed to.
>>>
>>> Andrew Stone
>>> Twitter / @twittelatorhttp://www.stone.com
>>> got iPhone?
>>>        http://tinyurl.com/twitpro
>>>        http://tinyurl.com/intentionizer
>>>        http://tinyurl.com/gesture-buy
>>>        http://tinyurl.com/igraffiti
>>>        http://tinyurl.com/talkingpics
>>>        http://tinyurl.com/mobilemix
>>>        http://tinyurl.com/soundbite
>>>        http://tinyurl.com/icreated
>>>        http://tinyurl.com/pulsar-app
>>>
>>> On Oct 30, 5:00 am, "David Neubauer" 
>>> wrote:
>>>
>>>
>>>
>>> > Has any figured out how to get a the lists I'm subscribed to. I didn't
>>> > realize how much I'd want this part of it. Please say it's coming...
>>>
>>> > -Original Message-
>>> > From: twitter-development-talk@googlegroups.com
>>>
>>> > [mailto:twitter-development-t...@googlegroups.com] On Behalf Of Jeremy 
>>> > Felt
>>> > Sent: Thursday, October 29, 2009 8:16 PM
>>> > To: Twitter Development Talk
>>> > Subject: [twitter-dev] Re: Updates to the List API (list descriptions,
>>> > cursoring lists of lists, finding by list id rather than slug & more
>>> > consistent names)
>>>
>>> > It appears that user/lists.xml only shows lists that are created by
>>> > the user and not those that they follow.
>>>
>>> > Any change coming to that or am I missing a way to see all lists that
>>> > a user follows?
>>>
>>> > Thanks,
>>> > Jeremy
>>>
>>> > On Oct 28, 3:00 pm, Marcel Molina  wrote:
>>> > > Two additions and two changes to the List API will be deployed in the
>>> > > next few days:
>>>
>>> > > * List descriptions
>>> > > We're adding a description to every list. You'll be able to specify a
>>> > > description when you create or update a list and the description will
>>> > > be included in the payload.
>>>
>>> > > * Cursoring through lists of lists
>>> > > All resources that return a list of lists will include next and
>>> > > previous cursors and will accept a :cursor parameter.
>>>
>>> > > * Finding by list id rather than slug
>>> > > When you change the name of a list, the slug will be updated to
>>> > > reflect that change. That means using the slug in the url for
>>> > > resources to operate on lists requires the onerous task of validating
>>> > > that the slug for the list you are about to do something with hasn't
>>> > > been updated since the last time you stored its slug. What a nightmare
>>> > > :-)
>>>
>>> > > Every list also has an id. This value won't change. We'll be changing
>>> > > the API to replace all instances of a list slug in urls to be list ids
>>> > > instead.
>>>
>>> > > * Consistent names
>>> > > The terminology we've used thus far for people you follow with a list
>>> > > is members. The terminology for people who are following a list is
>>> > > subscribers. We're going to mirror the terminology used for users and
>>> > > change it to followers and following respectively.
>>>
>>> > > So:
>>>
>>> > > /:user/lists/:list_id/memberships becomes 
>>> > > /:user/lists/:list_id/followers
>>>
>>> > > /:user/lists/:list_id/subscribers becomes 
>>> > > /:user/lists/:list_id/following
>>>
>>> > > As we deploy these changes we'll send out a heads up on the dev list
>>> > > and @twitterapi.
>>>
>>> > > --
>>> > > Marcel Molina
>>> > > Twitter Platform Teamhttp://twitter.com/noradio
>>
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Lists API

2009-11-02 Thread Marcel Molina

It's available to all developers and has been since last Thursday.

There are still some tweaks to be made but everything that works now
should continue to be supported along side the changes and additions
that will be introduced.

On Mon, Nov 2, 2009 at 9:48 AM, Michael Steuer  wrote:
> With all the discussions on this mailing list about the Lists API, can
> someone please confirm, is the API now available to all developers or all of
> you in some sort of preferred position?
>
> Thanks,
>
> Michael.



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Truncated URLs

2009-11-02 Thread Marcel Molina

I believe in that case the url is just truncated and gone. I believe
this only works when shortening it with bit.ly still wouldn't make the
tweet fewer than 140 characters. Though it seems unfortunate to lose
the url, in a sense you aren't missing data because *no one* gets that
url so ultimately it doesn't really exist :)

I'd imagine this is fairly rare, yes? I'd recommend just giving up and
skipping the tweet if the url isn't fully formed.

On Mon, Nov 2, 2009 at 6:51 AM, Adam Green  wrote:
>
> I'm extracting URLs from tweets, and some of them are truncated at the
> end of a tweet. The URL ends up as something like http://domain...
>
> I can't find anything in the API that will let me get the full URL, so
> I assume it is lost. Is this correct, or is there some trick to get
> back the entire URL before truncation?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Subscribed Lists

2009-11-02 Thread Marcel Molina

There is, in a sense, an API for resolving a list id by passing in a
slug. It's the show resource for a list. You'll either get a 404
(which means the slug no longer exist) or you'll get the list payload
which will include the id.

On Sun, Nov 1, 2009 at 11:29 PM, Rich  wrote:
>
> Using ID only for me is fine, except in the case we mention.  If there
> was a REST api to find a list ID based on a slug then it would mean we
> could still resolve @screen_name/list_name links otherwise we wouldn't
> be able to replicate it, except by brute force which would use yet
> more API calls.
>
> On Nov 1, 6:14 pm, Marcel Molina  wrote:
>> Resolving a @screen_name/list_name reference in a tweet is a
>> compelling argument for making the url parameter polymorphic and not
>> deprecating the use of slugs. I will cogitate.
>>
>>
>>
>>
>>
>> On Sun, Nov 1, 2009 at 10:09 AM,   wrote:
>> > I have to second Rich on this - ID-only is flawed, as twitter supports 
>> > hotlinking lists by name (@username/slug) in tweets, and links that to the 
>> > list page. If clients want to offer the same behavior, this is not 
>> > possible if the API only supports IDs (or would require a potentially 
>> > large number of additional requests to get the user's lists and page 
>> > through them to find the one mentioned).
>>
>> > Marco
>> > 
>>
>> > -Original Message-
>> > From: Marcel Molina 
>> > Date: Sun, 1 Nov 2009 10:02:31
>> > To: 
>> > Subject: [twitter-dev] Re: Subscribed Lists
>>
>> > Currently it's still slug. It hasn't been updated yet. When it is
>> > updated it will for some period of transition accept a slug or an id
>> > but eventually support for the slug in the url will be removed
>> > entirely.
>>
>> > On Sun, Nov 1, 2009 at 2:14 AM, Rich  wrote:
>>
>> >> Can we get some form of confirmation on the list slug/id issue.  At
>> >> the moment calling by ID doesn't work anyway so it's only using the
>> >> slug.
>>
>> >> My preference would be to allow either (in a similar way to the other
>> >> REST api's where you can use user id or screenName)
>>
>> >> On Oct 31, 10:04 pm, twittelator  wrote:
>> >>> :user/lists/subscriptions.:format
>>
>> >>> gets the lists that the user has subscribed to.
>>
>> >>> Andrew Stone
>> >>> Twitter / @twittelatorhttp://www.stone.com
>> >>> got iPhone?
>> >>>        http://tinyurl.com/twitpro
>> >>>        http://tinyurl.com/intentionizer
>> >>>        http://tinyurl.com/gesture-buy
>> >>>        http://tinyurl.com/igraffiti
>> >>>        http://tinyurl.com/talkingpics
>> >>>        http://tinyurl.com/mobilemix
>> >>>        http://tinyurl.com/soundbite
>> >>>        http://tinyurl.com/icreated
>> >>>        http://tinyurl.com/pulsar-app
>>
>> >>> On Oct 30, 5:00 am, "David Neubauer" 
>> >>> wrote:
>>
>> >>> > Has any figured out how to get a the lists I'm subscribed to. I didn't
>> >>> > realize how much I'd want this part of it. Please say it's coming...
>>
>> >>> > -----Original Message-
>> >>> > From: twitter-development-talk@googlegroups.com
>>
>> >>> > [mailto:twitter-development-t...@googlegroups.com] On Behalf Of Jeremy 
>> >>> > Felt
>> >>> > Sent: Thursday, October 29, 2009 8:16 PM
>> >>> > To: Twitter Development Talk
>> >>> > Subject: [twitter-dev] Re: Updates to the List API (list descriptions,
>> >>> > cursoring lists of lists, finding by list id rather than slug & more
>> >>> > consistent names)
>>
>> >>> > It appears that user/lists.xml only shows lists that are created by
>> >>> > the user and not those that they follow.
>>
>> >>> > Any change coming to that or am I missing a way to see all lists that
>> >>> > a user follows?
>>
>> >>> > Thanks,
>> >>> > Jeremy
>>
>> >>> > On Oct 28, 3:00 pm, Marcel Molina  wrote:
>> >>> > > Two additions and two changes to the List API will be deployed in the
>> >>> > > next few days:
>>
>> >>> >

[twitter-dev] Re: Lists API

2009-11-02 Thread Marcel Molina

You may (until further notice) ;-)

On Mon, Nov 2, 2009 at 10:12 AM,   wrote:
>
> Can I translate that into 'the current URL to get a list using the slug will 
> not be deprecated'?
>
> Marco
> 
>
> -Original Message-
> From: Marcel Molina 
> Date: Mon, 2 Nov 2009 10:05:03
> To: 
> Subject: [twitter-dev] Re: Lists API
>
>
> It's available to all developers and has been since last Thursday.
>
> There are still some tweaks to be made but everything that works now
> should continue to be supported along side the changes and additions
> that will be introduced.
>
> On Mon, Nov 2, 2009 at 9:48 AM, Michael Steuer  wrote:
>> With all the discussions on this mailing list about the Lists API, can
>> someone please confirm, is the API now available to all developers or all of
>> you in some sort of preferred position?
>>
>> Thanks,
>>
>> Michael.
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: update_delivery_device method

2009-11-02 Thread Marcel Molina

Please file a bug about this on our issue tracker if you haven't already:
http://code.google.com/p/twitter-api/issues/list

Thanks.

On Wed, Oct 28, 2009 at 11:55 PM, DustyReagan  wrote:
>
> I was playing around with the account/update_delivery_device method.
>
> It seems to behave like this:
>
> device=sms:im - Does nothing
> device=none - Turns device updates off
>
> Neither "sms" or "im" turn device updates back on.
>
> Are there any plans for this method to be updated or deprecated?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Subscribed Lists

2009-11-02 Thread Marcel Molina

Both will be allowed.

On Mon, Nov 2, 2009 at 1:34 PM, Rich  wrote:
>
> Thanks for that Marcel, well if it's decided to completely abandon
> slugs I'll have to go down that route.
>
> Any idea on whether both call types will be allowed yet?  Obviously
> the main lookups will are quick to switch between, just this
> @screen_name/list_name that'll take more work if we can't use the
> slug.
>
> On Nov 2, 6:12 pm, Marcel Molina  wrote:
>> There is, in a sense, an API for resolving a list id by passing in a
>> slug. It's the show resource for a list. You'll either get a 404
>> (which means the slug no longer exist) or you'll get the list payload
>> which will include the id.
>>
>>
>>
>>
>>
>> On Sun, Nov 1, 2009 at 11:29 PM, Rich  wrote:
>>
>> > Using ID only for me is fine, except in the case we mention.  If there
>> > was a REST api to find a list ID based on a slug then it would mean we
>> > could still resolve @screen_name/list_name links otherwise we wouldn't
>> > be able to replicate it, except by brute force which would use yet
>> > more API calls.
>>
>> > On Nov 1, 6:14 pm, Marcel Molina  wrote:
>> >> Resolving a @screen_name/list_name reference in a tweet is a
>> >> compelling argument for making the url parameter polymorphic and not
>> >> deprecating the use of slugs. I will cogitate.
>>
>> >> On Sun, Nov 1, 2009 at 10:09 AM,   wrote:
>> >> > I have to second Rich on this - ID-only is flawed, as twitter supports 
>> >> > hotlinking lists by name (@username/slug) in tweets, and links that to 
>> >> > the list page. If clients want to offer the same behavior, this is not 
>> >> > possible if the API only supports IDs (or would require a potentially 
>> >> > large number of additional requests to get the user's lists and page 
>> >> > through them to find the one mentioned).
>>
>> >> > Marco
>> >> > 
>>
>> >> > -Original Message-
>> >> > From: Marcel Molina 
>> >> > Date: Sun, 1 Nov 2009 10:02:31
>> >> > To: 
>> >> > Subject: [twitter-dev] Re: Subscribed Lists
>>
>> >> > Currently it's still slug. It hasn't been updated yet. When it is
>> >> > updated it will for some period of transition accept a slug or an id
>> >> > but eventually support for the slug in the url will be removed
>> >> > entirely.
>>
>> >> > On Sun, Nov 1, 2009 at 2:14 AM, Rich  wrote:
>>
>> >> >> Can we get some form of confirmation on the list slug/id issue.  At
>> >> >> the moment calling by ID doesn't work anyway so it's only using the
>> >> >> slug.
>>
>> >> >> My preference would be to allow either (in a similar way to the other
>> >> >> REST api's where you can use user id or screenName)
>>
>> >> >> On Oct 31, 10:04 pm, twittelator  wrote:
>> >> >>> :user/lists/subscriptions.:format
>>
>> >> >>> gets the lists that the user has subscribed to.
>>
>> >> >>> Andrew Stone
>> >> >>> Twitter / @twittelatorhttp://www.stone.com
>> >> >>> got iPhone?
>> >> >>>        http://tinyurl.com/twitpro
>> >> >>>        http://tinyurl.com/intentionizer
>> >> >>>        http://tinyurl.com/gesture-buy
>> >> >>>        http://tinyurl.com/igraffiti
>> >> >>>        http://tinyurl.com/talkingpics
>> >> >>>        http://tinyurl.com/mobilemix
>> >> >>>        http://tinyurl.com/soundbite
>> >> >>>        http://tinyurl.com/icreated
>> >> >>>        http://tinyurl.com/pulsar-app
>>
>> >> >>> On Oct 30, 5:00 am, "David Neubauer" 
>> >> >>> wrote:
>>
>> >> >>> > Has any figured out how to get a the lists I'm subscribed to. I 
>> >> >>> > didn't
>> >> >>> > realize how much I'd want this part of it. Please say it's coming...
>>
>> >> >>> > -Original Message-
>> >> >>> > From: twitter-development-talk@googlegroups.com
>>
>> >> >>> > [mailto:twitter-development-t...@googlegroups.com] On Behalf O

[twitter-dev] Re: Draft of List API documentation

2009-11-03 Thread Marcel Molina

A work around for environments that don't support the DELETE request
method is, I believe, to pass a parameter called _method with the
value "DELETE". In other words "_method=DELETE".

On Mon, Nov 2, 2009 at 11:26 PM, wilfred yau  wrote:
>
> It there any method to delete user from list other then using DELETE
> method?
> Since I am using Flex (but not Air) to develop third party Twitter
> Client, There are no way to call "DELETE" (which only GET and POST).
> So, will twitter provide POST or GET method API to "delete"? Thanks
>
>
> On Oct 16, 3:04 pm, Marcel Molina  wrote:
>> Hey folks. As some of you have likely read we're starting to do some
>> private beta testing of our new lists feature. We're not quite ready
>> to open it up to everyone but we've made some headway on the API and
>> wanted to share some details of what we've got so far.
>>
>> There are a handful of things on our todo lists so don't consider this
>> signed and sealed just yet.
>>
>> You may notice this API is a bit of a departure from the rest of the
>> API. It's a bit more, errr, REST than the rest.
>>
>> First off, here's the current payload for alist:
>>
>> 
>> 
>>   1416
>>   tall people
>>   @noradio/tall-people
>>   tall-people
>>   0
>>   3
>>   /noradio/tall-people
>>   public
>>   
>>     3191321
>>     Marcel Molina
>>     noradio
>>     San Francisco, CA
>>     Engineer at Twitter on the @twitterapi team, obsessed
>> with rock climbing & running. In a past life I was a member of the
>> Rails Core team.
>>     
>> http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_no...
>>     http://project.ioni.st
>>     false
>>     40059
>>     9AE4E8
>>     33
>>     0084B4
>>     DDFFCC
>>     BDDCAD
>>     354
>>     Mon Apr 02 07:47:28 + 2007
>>     131
>>     -28800
>>     Pacific Time (US & Canada)
>>     
>> http://a1.twimg.com/profile_background_images/18156348/jessica_tiled
>>     true
>>     3472
>>     false
>>     true
>>     false
>>     false
>>   
>> 
>>
>> === Lists ===
>>
>> POST '/:user/lists.:format'
>> Creates a newlistfor the authenticated user.
>>
>> Parameters:
>>  * name: the name of thelist. (required)
>>  * mode: whether yourlistis public of private. Values can be
>> 'public' or 'private'. Public by default if not specified. (optional)
>>
>> Usage notes:
>>  ":user" in the url should be the screen name of the user making the
>> request to create thelist
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -d "name=tall 
>> people&mode=private"http://twitter.com/noradio/lists.xml
>>
>> POST/PUT '/:user/lists/:list_slug.:format'
>> Updates the specifiedlist.
>>
>> Takes the same parameters as the create resource at POST
>> '/:user/lists.:format' (:name and :mode).
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -d 
>> "name=giants&mode=public"http://twitter.com/noradio/lists/tall-people.xml
>>
>> GET '/:user/lists.:format'
>> Lists your lists.
>>
>> Supported format:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORDhttp://twitter.com/noradio/lists.xml
>>
>> GET '/:user/lists/memberships.:format'Listthe lists the specified user has 
>> been added to.
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORDhttp://twitter.com/noradio/lists/memberships.xml
>>
>> DELETE '/:user/lists/:list_slug.:format'
>> Delete the specifiedlistowned by the authenticated user.
>>
>> Parameters:
>>  * list_slug: the slug of thelistyou want to delete. (required)
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u USERNAME:PASSWORD -X 
>> DELETEhttp://twitter.com/noradio/lists/tall-people.xml
>>
>> GET '/:users/lists/:list_slug/statuses.:format'
>> Show tweet timeline for members of the specifiedlist.
>>
>> Parameters:
>>  * list_slug: the slug of thelistyou want the member tweet timeline
>> of. (required)
>>  * next/previous_cursor: used to "page" through results (optional)
>>
>> Supporte

[twitter-dev] Re: List API : statuses timeline and count parameter

2009-11-03 Thread Marcel Molina

You can use all the same parameters as are available in the other
status timeline resources (e.g. max_id, count, since_id, etc).

On Tue, Nov 3, 2009 at 4:07 PM, stephane  wrote:
>
> Hi guys !
>
> Is there a way (or planned method) to get more than 20 statuses per
> list timeline API call ? apparently there is no equivalent to the
> count parameter.
>
> Best,
>
> Stephane Philipakis
> @sphilipakis
> www.twazzup.com
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: List API : statuses timeline and count parameter

2009-11-03 Thread Marcel Molina

Oh. I've realized that all the options *except* for count are
supported. Fixing that now. Should be deployed to production in the
next day or so. Thanks for reporting this.

On Tue, Nov 3, 2009 at 5:01 PM, Marcel Molina  wrote:
> You can use all the same parameters as are available in the other
> status timeline resources (e.g. max_id, count, since_id, etc).
>
> On Tue, Nov 3, 2009 at 4:07 PM, stephane  
> wrote:
>>
>> Hi guys !
>>
>> Is there a way (or planned method) to get more than 20 statuses per
>> list timeline API call ? apparently there is no equivalent to the
>> count parameter.
>>
>> Best,
>>
>> Stephane Philipakis
>> @sphilipakis
>> www.twazzup.com
>>
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Suggestion for User record

2009-11-03 Thread Marcel Molina

We've got this on our todo list. It requires fairly extensive
asynchronous fragment invalidation so it's not as simple as just
adding the count into the payload. We've got it on the list though.

On Sat, Oct 31, 2009 at 7:10 PM, Dave  Winer  wrote:
>
> It would be useful if a  had a lists_count element, in addition
> to the other counts (followers, statuses, favourites).
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: RSS support for Lists

2009-11-04 Thread Marcel Molina

We will be supporting atom for the statuses timeline of a list soon.

On Wed, Nov 4, 2009 at 6:17 AM, alexkingorg  wrote:
>
> [Sorry if this has been covered, I searched for a while before
> posting.]
>
> According to the documentation and my initial testing, there does not
> appear to be support for receiving data from a List in RSS format
> (only json and xml). Is there a reason why this hasn't been added or
> was it just not high enough priority and will get added at some point
> in the future?
>
> If you were waiting for someone to request it, I'm happy to fill that
> role. :)
>
> Thanks,
> --Alex
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Draft of List API documentation

2009-11-04 Thread Marcel Molina

We plan to support this. It's on the todo list. Thanks for the suggestion.

On Tue, Nov 3, 2009 at 8:38 PM, Damon Clinkscales  wrote:
>
> On Fri, Oct 16, 2009 at 1:04 AM, Marcel Molina  wrote:
>>
>> Hey folks. As some of you have likely read we're starting to do some
>> private beta testing of our new lists feature. We're not quite ready
>> to open it up to everyone but we've made some headway on the API and
>> wanted to share some details of what we've got so far.
>>
>> There are a handful of things on our todo lists so don't consider this
>> signed and sealed just yet.
>
> Marcel,
>
> It would be nice if we could pass in either the user_id or the
> screen_name, wherever you are currently requiring a Twitter user id.
> This would be consistent with the rest of the REST API (and quite
> useful, saving an extra call).
>
> Thanks,
> -damon
> --
> http://twitter.com/damon
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Since_ID and Search Problem

2009-11-04 Thread Marcel Molina

I've talked with the search team and there's a known condition where
10 of our servers are behind the others that can cause varying results
across requests. We're aware of the issue, it is ticket and we are
working on it.

On Wed, Nov 4, 2009 at 3:45 AM, Spode  wrote:
>
> Hi,
>
> I've been noticing some strange behaviour since last night - but
> that's not to say it's not been going on longer.
>
> http://search.twitter.com/search.json?q=JournoTwit&rpp=100&since_id=5402169538
>
> Performing this search turns up 0 results when it should show 4.
>
> http://search.twitter.com/search.json?q=JournoTwit&rpp=100&since_id=
>
> Run it with no since_id and it works. Then straight away run the
> original query...
>
> http://search.twitter.com/search.json?q=JournoTwit&rpp=100&since_id=5402169538
>
> And you get the expected 4 results.
>
> What's going on?
>
> Spode (journotwit.com)
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Background images on a0.twimg.com giving access denied

2009-11-04 Thread Marcel Molina

Thanks for reporting this. I've forwarded this to the team responsible
for the S3 uploading.

On Wed, Nov 4, 2009 at 10:28 AM, Kevin  wrote:
>
> We are uploading Twitter backgrounds via the API. We noticed today new
> attempts to upload seem to be successful, but the profiles show no
> background image. Looking at the page source, it shows a new
> background image URL:
>  background: ... url('http://a0.twimg.com/profile_background_images/
> bg12573586264055.jpg') ...;
>
> However, opening that URL returns an error:
> 
> AccessDeniedAccess Denied Message>20FB3BC5AEC2A2D5KheAYU8E/puKx
> +qm5jtF9YeLLfc/NHcoCr6q2iOWZy2OR3tbtouA3Fo5aTrHUrZn
>
> It would appear Twitter is not adding the S3 access key query string
> to these background image URLs, or the images are being put into S3 as
> private items.
>
> Hope to see a fix soon.
> Regards,
> Kevin Hunt
> Bubble Fusion Labs
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Draft of List API documentation

2009-11-05 Thread Marcel Molina

I think it should work for any request. Not sure though. Give it a try ;-)

On Thu, Nov 5, 2009 at 5:48 AM, Paul Kinlan  wrote:
> Can you confirm that _method=DELETE only works on POST's and not GET's?
> Paul
>
> 2009/11/3 Marcel Molina 
>>
>> A work around for environments that don't support the DELETE request
>> method is, I believe, to pass a parameter called _method with the
>> value "DELETE". In other words "_method=DELETE".
>>
>> On Mon, Nov 2, 2009 at 11:26 PM, wilfred yau  wrote:
>> >
>> > It there any method to delete user from list other then using DELETE
>> > method?
>> > Since I am using Flex (but not Air) to develop third party Twitter
>> > Client, There are no way to call "DELETE" (which only GET and POST).
>> > So, will twitter provide POST or GET method API to "delete"? Thanks
>> >
>> >
>> > On Oct 16, 3:04 pm, Marcel Molina  wrote:
>> >> Hey folks. As some of you have likely read we're starting to do some
>> >> private beta testing of our new lists feature. We're not quite ready
>> >> to open it up to everyone but we've made some headway on the API and
>> >> wanted to share some details of what we've got so far.
>> >>
>> >> There are a handful of things on our todo lists so don't consider this
>> >> signed and sealed just yet.
>> >>
>> >> You may notice this API is a bit of a departure from the rest of the
>> >> API. It's a bit more, errr, REST than the rest.
>> >>
>> >> First off, here's the current payload for alist:
>> >>
>> >> 
>> >> 
>> >>   1416
>> >>   tall people
>> >>   @noradio/tall-people
>> >>   tall-people
>> >>   0
>> >>   3
>> >>   /noradio/tall-people
>> >>   public
>> >>   
>> >>     3191321
>> >>     Marcel Molina
>> >>     noradio
>> >>     San Francisco, CA
>> >>     Engineer at Twitter on the @twitterapi team, obsessed
>> >> with rock climbing & running. In a past life I was a member of the
>> >> Rails Core team.
>> >>
>> >> http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_no...
>> >>     http://project.ioni.st
>> >>     false
>> >>     40059
>> >>     9AE4E8
>> >>     33
>> >>     0084B4
>> >>     DDFFCC
>> >>     BDDCAD
>> >>     354
>> >>     Mon Apr 02 07:47:28 + 2007
>> >>     131
>> >>     -28800
>> >>     Pacific Time (US & Canada)
>> >>
>> >> http://a1.twimg.com/profile_background_images/18156348/jessica_tiled
>> >>     true
>> >>     3472
>> >>     false
>> >>     true
>> >>     false
>> >>     false
>> >>   
>> >> 
>> >>
>> >> === Lists ===
>> >>
>> >> POST '/:user/lists.:format'
>> >> Creates a newlistfor the authenticated user.
>> >>
>> >> Parameters:
>> >>  * name: the name of thelist. (required)
>> >>  * mode: whether yourlistis public of private. Values can be
>> >> 'public' or 'private'. Public by default if not specified. (optional)
>> >>
>> >> Usage notes:
>> >>  ":user" in the url should be the screen name of the user making the
>> >> request to create thelist
>> >>
>> >> Supported formats:
>> >> xml, json
>> >>
>> >> e.g.
>> >>  curl -u USERNAME:PASSWORD -d "name=tall
>> >> people&mode=private"http://twitter.com/noradio/lists.xml
>> >>
>> >> POST/PUT '/:user/lists/:list_slug.:format'
>> >> Updates the specifiedlist.
>> >>
>> >> Takes the same parameters as the create resource at POST
>> >> '/:user/lists.:format' (:name and :mode).
>> >>
>> >> Supported formats:
>> >> xml, json
>> >>
>> >> e.g.
>> >>  curl -u USERNAME:PASSWORD -d
>> >> "name=giants&mode=public"http://twitter.com/noradio/lists/tall-people.xml
>> >>
>> >> GET '/:user/lists.:format'
>> >> Lists your lists.
>> >>
>> >>

[twitter-dev] Re: Draft of List API documentation

2009-11-05 Thread Marcel Molina

Status timelines paginate with the page parameters. Social graph
resources such as the members in a list use the cursor parameters.
We're looking to rationalize all this as we move to new systems but
for now there are different interfaces. You use the same mechanisms
for the list statuses timeline as you do for all other status
timelines.

On Thu, Nov 5, 2009 at 7:05 AM, Milen  wrote:
>
> I think that all methods which refer to lists should use the id, not
> the slug. As people have mentioned, the slug can change, so in order
> to reliably delete a list, you will have to fetch its slug and then
> issue a delete (or you risk getting an error as the slug might have
> changed in the meantime).
>
> I also tried to "page" through the statuses in a list but it seemed
> that:
> - next_cursor / previous_cursor had no effect on what was returned
> - cursor=-1 or anything else didn't have an effect
>
> Can anyone shed some light on how we're supposed to do paging?
>
> Thanks,
> M
>
> On Oct 16, 7:04 am, Marcel Molina  wrote:
>
>> GET '/:users/lists/:list_slug/statuses.:format'
>> Show tweet timeline for members of the specified list.
>>
>> Parameters:
>>  * list_slug: the slug of the list you want the member tweet timeline
>> of. (required)
>>  * next/previous_cursor: used to "page" through results (optional)
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u 
>> USERNAME:PASSWORDhttp://twitter.com/noradio/lists/tall-people/statuses.xml
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Draft of List API documentation

2009-11-05 Thread Marcel Molina

We will support specifying a list by both id and slug indefinitely.
Though we recognize the short comings of finding by slug since they
are prone to changing, there are use cases where finding by slug is a
lot more convenient. So we'll be supporting both. You never *have* to
search by slug :-)

On Thu, Nov 5, 2009 at 7:05 AM, Milen  wrote:
>
> I think that all methods which refer to lists should use the id, not
> the slug. As people have mentioned, the slug can change, so in order
> to reliably delete a list, you will have to fetch its slug and then
> issue a delete (or you risk getting an error as the slug might have
> changed in the meantime).
>
> I also tried to "page" through the statuses in a list but it seemed
> that:
> - next_cursor / previous_cursor had no effect on what was returned
> - cursor=-1 or anything else didn't have an effect
>
> Can anyone shed some light on how we're supposed to do paging?
>
> Thanks,
> M
>
> On Oct 16, 7:04 am, Marcel Molina  wrote:
>
>> GET '/:users/lists/:list_slug/statuses.:format'
>> Show tweet timeline for members of the specified list.
>>
>> Parameters:
>>  * list_slug: the slug of the list you want the member tweet timeline
>> of. (required)
>>  * next/previous_cursor: used to "page" through results (optional)
>>
>> Supported formats:
>> xml, json
>>
>> e.g.
>>  curl -u 
>> USERNAME:PASSWORDhttp://twitter.com/noradio/lists/tall-people/statuses.xml
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Is image shrinking broken?

2009-11-05 Thread Marcel Molina

I've passed this issue along to the team that owns the image resizing
code to see if they have any insights into what the issue might be.

On Mon, Nov 2, 2009 at 9:25 PM, TCI  wrote:
>
> I am noticing an increase in the number of avatar images which do not
> get shrinked in the smaller versions. It is most noticeable in the
> twitter.com homepage as the images load very slowly from top to
> bottom. How are your clients handling this? In my case I am assuming
> the shrinking is working and therefore my page load times are being
> affected.
>
> Example:
>
> http://a3.twimg.com/profile_images/506101471/Copy__2__of_Francesca__4__bigger.jpg
> http://a3.twimg.com/profile_images/506101471/Copy__2__of_Francesca__4__normal.jpg
> http://a3.twimg.com/profile_images/506101471/Copy__2__of_Francesca__4__mini.jpg
>
> are all the same...
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Background images on a0.twimg.com giving access denied

2009-11-05 Thread Marcel Molina

To follow up I've been told that this is the most critical bug they
are working on right now. So it's being worked on. I'll pass along
updates as provided.

On Wed, Nov 4, 2009 at 1:57 PM, Marcel Molina  wrote:
> Thanks for reporting this. I've forwarded this to the team responsible
> for the S3 uploading.
>
> On Wed, Nov 4, 2009 at 10:28 AM, Kevin  wrote:
>>
>> We are uploading Twitter backgrounds via the API. We noticed today new
>> attempts to upload seem to be successful, but the profiles show no
>> background image. Looking at the page source, it shows a new
>> background image URL:
>>  background: ... url('http://a0.twimg.com/profile_background_images/
>> bg12573586264055.jpg') ...;
>>
>> However, opening that URL returns an error:
>> 
>> AccessDeniedAccess Denied> Message>20FB3BC5AEC2A2D5KheAYU8E/puKx
>> +qm5jtF9YeLLfc/NHcoCr6q2iOWZy2OR3tbtouA3Fo5aTrHUrZn
>>
>> It would appear Twitter is not adding the S3 access key query string
>> to these background image URLs, or the images are being put into S3 as
>> private items.
>>
>> Hope to see a fix soon.
>> Regards,
>> Kevin Hunt
>> Bubble Fusion Labs
>>
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Oauth and (lack) delegation

2009-11-05 Thread Marcel Molina

We've got a project lined up to come up with an answer for OAuth app
delegation problem. We haven't done a deep dive into what the approach
might be yet so we don't have any ideas yet. Would be glad to have the
conversation with those who are interested and have ideas.

On Thu, Nov 5, 2009 at 4:20 PM, Michael Steuer  wrote:
> Does Twitter (or anyone else) have thoughts around the lack of delegation in
> Oauth and the announced deprecation of basic authentication? Currently, to
> enable an API that allows web services to interact with Twitter on its
> behalf (e.g. TwitPic, yFrog, etc.) one has to rely on basic authentication
> (the twitter client passing the user’s username & password to the web
> services API), as delegation is not possible via Oauth... If a user
> authenticates with my application via Oauth, there’s no way I can have a 3rd
> party API do anything on behalf of that user...
>
> Similarly, if I want to develop an API to my Twitter web service, I would
> have to develop that with basic authentication, but what’s the point:
>
> knowing that basic auth is going to be deprecated in the (near) future
> so many apps are now based on oauth and wouldn’t be able to use my API
> because they can’t authenticate
>
> I’m sure other devs have run into this. Does Twitter have any thoughts
> around this? How do you expect to maintain a 3rd party app/API eco system
> after basic auth deprecation?
>
> Looking forward to everyone’s feedback..



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: api.twitter.com not returning compressed data

2009-11-05 Thread Marcel Molina

We've confirmed this and reported it to our operations team. We've
identified the problem and are actively fixing it. Thanks for the
detailed report. I'll let you know when the gzip compression is
restored.

On Thu, Nov 5, 2009 at 7:19 PM, Jason Diller  wrote:
>
> API calls to http://twitter.com/ with Accept-Encoding:gzip in the
> headers are
> returning compressed data, while calls to http://api.twitter.com/1/
> with the same
> headers do not.
>
> You can demonstrate this with cUrl:
> curl --basic -u "user:pass" --header "Accept-Encoding:gzip, deflate"
> http://api.twitter.com/1/statuses/friends_timeline.json
>
> vs.
>
> curl --basic -u "user:pass" --header "Accept-Encoding:gzip, deflate"
> http://twitter.com/statuses/friends_timeline.json
>
> In the second example, you will get garbled response indicating that
> the data is
> compressed, whereas in the first you will get clear text. (Note: if
> you use
> --compress instead of --header then cUrl will decompress the response
> so you'll have
> to use Wireshark or some other network sniffer to see the raw data).
>
> We tracked this down because one of our users in Europe reported a big
> perf hit after we switched to the versioned endpoint.  (see
> http://code.google.com/p/tweetsharp/issues/detail?id=104)
>
> I hope this isn't by design.
>
> Jason Diller
> Tweetsharp Contributor
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Getting user info from REST interface using name and not screen name

2009-11-05 Thread Marcel Molina

There is no API for that at the moment. We're developing an API for
people search though.

On Thu, Nov 5, 2009 at 6:38 PM, Kripashankar  wrote:
>
> Hi,
>
> I am developing a small prototype and would like to know the
> following.
>
>
> 1. How can I get info about a user given only the name and not screen
> name ?
>
>    Example:
>    http://twitter.com/users/show.xml?screen_name=aplusk
>
> gives me info about ashton kutcher but let's say I don't know the
> screen name but only know the name "Ashton Kutcher". How can I get the
> corresponding screen name and id, or the user info with just the
> name ? The api
>
> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-users%C2%A0show
>
> doesn't seem to take name as a parameter.
>
> BTW, I noticed two user info
> http://twitter.com/users/show.xml?screen_name=aplusk
> http://twitter.com/users/show.xml?screen_name=ashtonkutcher
>
> So I am not sure which is the right one as well for Ashton Kutcher.
>
> Any help much appreciated.
>
> Thanks!
>
>
>
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: api.twitter.com not returning compressed data

2009-11-05 Thread Marcel Molina

The configuration has been fixed. The configuration updates should be
pushed out to all servers tomorrow morning PST.

On Thu, Nov 5, 2009 at 8:20 PM, Marcel Molina  wrote:
> We've confirmed this and reported it to our operations team. We've
> identified the problem and are actively fixing it. Thanks for the
> detailed report. I'll let you know when the gzip compression is
> restored.
>
> On Thu, Nov 5, 2009 at 7:19 PM, Jason Diller  wrote:
>>
>> API calls to http://twitter.com/ with Accept-Encoding:gzip in the
>> headers are
>> returning compressed data, while calls to http://api.twitter.com/1/
>> with the same
>> headers do not.
>>
>> You can demonstrate this with cUrl:
>> curl --basic -u "user:pass" --header "Accept-Encoding:gzip, deflate"
>> http://api.twitter.com/1/statuses/friends_timeline.json
>>
>> vs.
>>
>> curl --basic -u "user:pass" --header "Accept-Encoding:gzip, deflate"
>> http://twitter.com/statuses/friends_timeline.json
>>
>> In the second example, you will get garbled response indicating that
>> the data is
>> compressed, whereas in the first you will get clear text. (Note: if
>> you use
>> --compress instead of --header then cUrl will decompress the response
>> so you'll have
>> to use Wireshark or some other network sniffer to see the raw data).
>>
>> We tracked this down because one of our users in Europe reported a big
>> perf hit after we switched to the versioned endpoint.  (see
>> http://code.google.com/p/tweetsharp/issues/detail?id=104)
>>
>> I hope this isn't by design.
>>
>> Jason Diller
>> Tweetsharp Contributor
>>
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Authentication not required for Twitter REST API Method

2009-11-05 Thread Marcel Molina

The statuses timeline does not in fact require authentication. I'll
update the docs. This was an oversight. Thanks.

On Thu, Nov 5, 2009 at 9:37 PM, davidzimm  wrote:
>
> The API description says that authentication is supposed to be
> required, but it is not. I don't know if this is a typo or if
> something is wrong, but you don't have to be authenticated to get the
> updates of a twitter list by ATOM (or any other format, for that
> matter).
>
> Not that I'm complaining:
> http://www.dizzysoft.com/twitter/twitter-lists-text-messages
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: /statuses/retweeted_to_me.xml?count=200 yields HTTP 500

2009-11-06 Thread Marcel Molina

Thanks for the report. Will try to recreate & look into it.

On Fri, Nov 6, 2009 at 12:35 AM, Dave Briccetti  wrote:
>
> BY ME: http://twitter.com/statuses/retweeted_by_me.xml?count=200 works
> just fine.
>
> TO ME: /statuses/retweeted_to_me.xml?count=10 works fine.
>
> User dcbriccetti
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Question about versioning

2009-11-06 Thread Marcel Molina

We do not have plans to support minor versions initially. We're going
to start with the simplest versioning scheme possible and then expand
it to include minor versions when the need arises.

So as of right now version 1 already exists, at
http://api.twitter.com/1. As for whether it should be considered
"stable", I'd say it's very close to being so. I've been using it
exclusively on my Twitter clients for several months. Since announcing
it publicly a couple weeks ago the only reports of irregularities have
been around server configuration (e.g. some requests over ssl getting
an untrusted cert error and requests for gzipped responses not being
configured correctly). As for the behavior of the API it should be
100% compatible with the non versioned twitter.com API.

On Thu, Nov 5, 2009 at 7:36 AM, DeWitt Clinton  wrote:
> Hi all,
> I'd like to sync the version numbers and release cycles of a few twitter
> libraries (python-twitter and java-twitter) up with the version of the
> Twitter API itself.  I'll admit that I've fallen way behind on
> the maintenance of each, partly because the Twitter API itself is a moving
> target (not a bad thing, just hard to keep in sync with).
> What's the expected timing of when we can rely on a stable versioned
> endpoint for v1, v2, etc, and bleeding-edge API versions?  In theory we'd do
> parallel releases on major/minor releases, and keep a dev branch open for
> the latest-and-greatest-and-beta-est version of the Twitter API.
> -DeWitt



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: can FOLLOW, but can't LEAVE

2009-11-09 Thread Marcel Molina

I've passed this along to our mobile team. Will update when I hear
back from them. Thanks for reporting this.

On Mon, Nov 9, 2009 at 2:24 PM, Cameron Kaiser  wrote:
>
> I have users complaining that of the commands listed on
>
>        http://help.twitter.com/forums/59008/entries/14020
>
> they all still work right for status updates *except* LEAVE (FOLLOW
> *does* work). On my own testing, LEAVE just appears to do nothing. Did
> this break?
>
> --
>  personal: http://www.cameronkaiser.com/ 
> --
>  Cameron Kaiser * Floodgap Systems * www.floodgap.com * ckai...@floodgap.com
> -- Never explain, never apologise. -- John Arbuthnot "Jackie" Fisher 
> --
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: can FOLLOW, but can't LEAVE

2009-11-09 Thread Marcel Molina

The mobile team can't reproduce this problem. Several of them tried
and LEAVE worked for all of them...

On Mon, Nov 9, 2009 at 2:28 PM, Marcel Molina  wrote:
> I've passed this along to our mobile team. Will update when I hear
> back from them. Thanks for reporting this.
>
> On Mon, Nov 9, 2009 at 2:24 PM, Cameron Kaiser  wrote:
>>
>> I have users complaining that of the commands listed on
>>
>>        http://help.twitter.com/forums/59008/entries/14020
>>
>> they all still work right for status updates *except* LEAVE (FOLLOW
>> *does* work). On my own testing, LEAVE just appears to do nothing. Did
>> this break?
>>
>> --
>>  personal: http://www.cameronkaiser.com/ 
>> --
>>  Cameron Kaiser * Floodgap Systems * www.floodgap.com * ckai...@floodgap.com
>> -- Never explain, never apologise. -- John Arbuthnot "Jackie" Fisher 
>> --
>>
>
>
>
> --
> Marcel Molina
> Twitter Platform Team
> http://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Count for statuses from a list appears to do nothing

2009-11-10 Thread Marcel Molina

You can use the "per_page" parameter for this. I'll update the
documentation. Should probably support "count" as well as an alias.

On Mon, Nov 9, 2009 at 5:15 PM, Ryan Bigg  wrote:
>
> Specifying different count on the request appears to send back the
> same file:
>
> ryanb...@fp:mocra-web (master)$ wget "http://api.twitter.com/1/drnic/
> lists/mocra/statuses.json?callback=updateTwitter()&count=100"
> --2009-11-10 11:13:41--  
> http://api.twitter.com/1/drnic/lists/mocra/statuses.json?callback=updateTwitter()&count=100
> Resolving api.twitter.com... 128.121.146.109
> Connecting to api.twitter.com|128.121.146.109|:80... connected.
> HTTP request sent, awaiting response... 200 OK
> Length: 24800 (24K) [application/json]
> Saving to: `statuses.json?callback=updateTwitter()&count=100'
>
> 100%
> [==>]
> 24,800      --.-K/s   in 0.02s
>
> 2009-11-10 11:13:42 (1.56 MB/s) - `statuses.json?callback=updateTwitter
> ()&count=100' saved [24800/24800]
>
> ryanb...@fp:mocra-web (master)$ wget "http://api.twitter.com/1/drnic/
> lists/mocra/statuses.json?callback=updateTwitter()&count=5"
> --2009-11-10 11:13:51--  
> http://api.twitter.com/1/drnic/lists/mocra/statuses.json?callback=updateTwitter()&count=5
> Resolving api.twitter.com... 128.121.146.109
> Connecting to api.twitter.com|128.121.146.109|:80... connected.
> HTTP request sent, awaiting response... 200 OK
> Length: 24800 (24K) [application/json]
> Saving to: `statuses.json?callback=updateTwitter()&count=5'
>
> 100%
> [==>]
> 24,800      --.-K/s   in 0.02s
>
> 2009-11-10 11:13:51 (1.37 MB/s) - `statuses.json?callback=updateTwitter
> ()&count=5' saved [24800/24800]
>
> ryanb...@fp:mocra-web (master)$
>
> Even though the API here says you can specify one:
> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-list-statuses?SearchFor=%3AList&sp=5
>
> What gives?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: 500 ISE on List API Update?

2009-11-10 Thread Marcel Molina

Yes we've been made aware of this. It should be noted that the update
sticks despite the 500 response. It's on our todo list of things to
investigate. Thanks for reporting it.

On Tue, Nov 10, 2009 at 9:48 AM, Aaron Brazell  wrote:
> I seem to be getting 500 Internal Server Errors on the List API for updating
> a list. Can anyone verify?
>
> Aaron Brazell
> CEO, Emmense Technologies
> Lead Editor, Technosailor.com
> Author, The WordPress Bible
>
> e: aa...@technosailor.com
> b: http://technosailor.com
> t: http://twitter.com/technosailor
> p: 443-455-1056Aaron Brazell
> web:: www.technosailor.com
> phone:: 410-608-6620
> skype:: technosailor
> twitter:: @technosailor
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: direct messages to lists

2009-11-10 Thread Marcel Molina

That is indeed an interesting idea that we've been thinking about. The
rules around who can send and receive DMs would continue to be
enforced as normal, so for talking purposes, if you DMed a list, only
those who follow you would receive it.

On Tue, Nov 10, 2009 at 9:21 AM, Marcus Better  wrote:
>
> -BEGIN PGP SIGNED MESSAGE-
> Hash: SHA1
>
> Hi,
>
> have you considered adding a mechanism for sending a sort of "direct
> message" to a list?
>
> This would allow users to send targeted tweets to a list (provided the
> user is a member of the list). It could be incredibly useful. For
> example tweets on a specific topic could be targeted to a selected
> interest group, without bothering your general followers.
>
> Currently the only granularity provided is "whole world" (tweet) and
> "single recipient" (direct message), but this would allow new use cases,
> for example something similar to a mailing list.
>
> Cheers,
>
> Marcus
> -BEGIN PGP SIGNATURE-
> Version: GnuPG v1.4.10 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iEYEARECAAYFAkr5oQUACgkQXjXn6TzcAQk+PgCfemGcdxyqZZrg1tNsxTWhna39
> gdAAoLJZHsM8yIqxzpHMp3XlYue2ODpz
> =ARYR
> -END PGP SIGNATURE-
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: direct messages to lists

2009-11-10 Thread Marcel Molina

As with all things, there will certainly be vectors for abuse. For
every bad use case, there are just as many or more positive use cases.
We'll certainly be thinking about many on both sides. Thanks for
pointing out some of the potential hazards.

On Tue, Nov 10, 2009 at 10:28 AM, Dewald Pretorius  wrote:
>
> Marcel,
>
> How would that be different from sending bulk DMs - something I have
> been advised in the past is not something that Twitter condones.
>
> Here's the scenario.
>
> MarketerMario has 2,000 followers. He creates four lists and adds 500
> of his followers to each list. Now he can send, with four simple
> clicks, his tweet whitening affiliate link to all his followers.
>
> Dewald
>
> On Nov 10, 2:19 pm, Marcel Molina  wrote:
>> That is indeed an interesting idea that we've been thinking about. The
>> rules around who can send and receive DMs would continue to be
>> enforced as normal, so for talking purposes, if you DMed a list, only
>> those who follow you would receive it.
>>
>>
>>
>> On Tue, Nov 10, 2009 at 9:21 AM, Marcus Better  wrote:
>>
>> > -BEGIN PGP SIGNED MESSAGE-
>> > Hash: SHA1
>>
>> > Hi,
>>
>> > have you considered adding a mechanism for sending a sort of "direct
>> > message" to a list?
>>
>> > This would allow users to send targeted tweets to a list (provided the
>> > user is a member of the list). It could be incredibly useful. For
>> > example tweets on a specific topic could be targeted to a selected
>> > interest group, without bothering your general followers.
>>
>> > Currently the only granularity provided is "whole world" (tweet) and
>> > "single recipient" (direct message), but this would allow new use cases,
>> > for example something similar to a mailing list.
>>
>> > Cheers,
>>
>> > Marcus
>> > -----BEGIN PGP SIGNATURE-
>> > Version: GnuPG v1.4.10 (GNU/Linux)
>> > Comment: Using GnuPG with Mozilla -http://enigmail.mozdev.org
>>
>> > iEYEARECAAYFAkr5oQUACgkQXjXn6TzcAQk+PgCfemGcdxyqZZrg1tNsxTWhna39
>> > gdAAoLJZHsM8yIqxzpHMp3XlYue2ODpz
>> > =ARYR
>> > -END PGP SIGNATURE-
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: 500 ISE on List API Update?

2009-11-10 Thread Marcel Molina

Worksforme:

mar...@albatross:~TW% master ./bin/twurl /1/noradio/lists/1416.xml


  1416
  tall people
  @noradio/tall-people
  tall-people
  3
  3
  /noradio/tall-people
  public
  

etc ...

On Tue, Nov 10, 2009 at 10:19 AM, Aaron Brazell  wrote:
> On Tue, Nov 10, 2009 at 1:16 PM, Marcel Molina  wrote:
>>
>> Yes we've been made aware of this. It should be noted that the update
>> sticks despite the 500 response. It's on our todo list of things to
>> investigate. Thanks for reporting it.
>>
>
> Excellent. While we're at it, we're 404ing on the GET List ID API.... In
> case you didn't know that as well :)



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Blocking vs non-blocking list creation: list streams are different

2009-11-10 Thread Marcel Molina

Indeed something looks strange there. I've brought this to the
attention of the team working on the lists backend. I'll let you know
what they discover.

On Mon, Nov 9, 2009 at 10:20 PM, Eric Gilbert  wrote:
>
> I'm developing an app that builds a few lists. Since it seems the only
> way to add users to lists is one id per call (please let me know if
> I'm mistaken), I experimented with populating the lists
> asynchronously. Both seem to build the list fine, and of course async
> is much faster. Here's the strange thing: although the lists created
> with each method have the same membership list, the lists streams are
> not the same. (Sync seems to be doing the right thing, but I haven't
> verified this rigorously.) For example, see
>
> http://twitter.com/eegilbert/right   vs
> http://twitter.com/eegilbert/notsoright
>
> Strange.
>
> Cheers,
> Eric
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: direct messages to lists

2009-11-10 Thread Marcel Molina

But people who are added to MarketerMario's list won't get his list
broadcasts unless they follow him. That's their "opt-in". If they have
followed him for whatever reason and decide they do *not* want his
broadcasts, they can simply unfollow him.

On Tue, Nov 10, 2009 at 10:46 AM, Dewald Pretorius  wrote:
>
> Marcel,
>
> You can circumvent the issue by making the receiving of a DM that is
> sent to a list dependent on two triggers:
>
> a) You must follow the sender of the DM; and
>
> b) You must explicitly double opt-in to receive DMs that are sent to
> the list.
>
> Bona fide use cases will be able to acquire the double opt-ins from
> interested users, while most people will simply not opt-in when
> MarketerMario adds them to his list.
>
> Dewald
>
> On Nov 10, 2:34 pm, Marcel Molina  wrote:
>> As with all things, there will certainly be vectors for abuse. For
>> every bad use case, there are just as many or more positive use cases.
>> We'll certainly be thinking about many on both sides. Thanks for
>> pointing out some of the potential hazards.
>>
>>
>>
>> On Tue, Nov 10, 2009 at 10:28 AM, Dewald Pretorius  wrote:
>>
>> > Marcel,
>>
>> > How would that be different from sending bulk DMs - something I have
>> > been advised in the past is not something that Twitter condones.
>>
>> > Here's the scenario.
>>
>> > MarketerMario has 2,000 followers. He creates four lists and adds 500
>> > of his followers to each list. Now he can send, with four simple
>> > clicks, his tweet whitening affiliate link to all his followers.
>>
>> > Dewald
>>
>> > On Nov 10, 2:19 pm, Marcel Molina  wrote:
>> >> That is indeed an interesting idea that we've been thinking about. The
>> >> rules around who can send and receive DMs would continue to be
>> >> enforced as normal, so for talking purposes, if you DMed a list, only
>> >> those who follow you would receive it.
>>
>> >> On Tue, Nov 10, 2009 at 9:21 AM, Marcus Better  wrote:
>>
>> >> > -BEGIN PGP SIGNED MESSAGE-
>> >> > Hash: SHA1
>>
>> >> > Hi,
>>
>> >> > have you considered adding a mechanism for sending a sort of "direct
>> >> > message" to a list?
>>
>> >> > This would allow users to send targeted tweets to a list (provided the
>> >> > user is a member of the list). It could be incredibly useful. For
>> >> > example tweets on a specific topic could be targeted to a selected
>> >> > interest group, without bothering your general followers.
>>
>> >> > Currently the only granularity provided is "whole world" (tweet) and
>> >> > "single recipient" (direct message), but this would allow new use cases,
>> >> > for example something similar to a mailing list.
>>
>> >> > Cheers,
>>
>> >> > Marcus
>> >> > -BEGIN PGP SIGNATURE-
>> >> > Version: GnuPG v1.4.10 (GNU/Linux)
>> >> > Comment: Using GnuPG with Mozilla -http://enigmail.mozdev.org
>>
>> >> > iEYEARECAAYFAkr5oQUACgkQXjXn6TzcAQk+PgCfemGcdxyqZZrg1tNsxTWhna39
>> >> > gdAAoLJZHsM8yIqxzpHMp3XlYue2ODpz
>> >> > =ARYR
>> >> > -END PGP SIGNATURE-
>>
>> >> --
>> >> Marcel Molina
>> >> Twitter Platform Teamhttp://twitter.com/noradio
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: direct messages to lists

2009-11-10 Thread Marcel Molina

I'm not saying any of this is being implemented. I'm just responding
in the abstract about the scenario you were proposing.

On Tue, Nov 10, 2009 at 11:08 AM, Dewald Pretorius  wrote:
>
> Marcel,
>
> You should talk to Jillian about this as well. I'm sure she will have
> a contrary opinion on the matter.
>
> Dewald
>
> On Nov 10, 2:51 pm, Marcel Molina  wrote:
>> But people who are added to MarketerMario's list won't get his list
>> broadcasts unless they follow him. That's their "opt-in". If they have
>> followed him for whatever reason and decide they do *not* want his
>> broadcasts, they can simply unfollow him.
>>
>>
>>
>> On Tue, Nov 10, 2009 at 10:46 AM, Dewald Pretorius  wrote:
>>
>> > Marcel,
>>
>> > You can circumvent the issue by making the receiving of a DM that is
>> > sent to a list dependent on two triggers:
>>
>> > a) You must follow the sender of the DM; and
>>
>> > b) You must explicitly double opt-in to receive DMs that are sent to
>> > the list.
>>
>> > Bona fide use cases will be able to acquire the double opt-ins from
>> > interested users, while most people will simply not opt-in when
>> > MarketerMario adds them to his list.
>>
>> > Dewald
>>
>> > On Nov 10, 2:34 pm, Marcel Molina  wrote:
>> >> As with all things, there will certainly be vectors for abuse. For
>> >> every bad use case, there are just as many or more positive use cases.
>> >> We'll certainly be thinking about many on both sides. Thanks for
>> >> pointing out some of the potential hazards.
>>
>> >> On Tue, Nov 10, 2009 at 10:28 AM, Dewald Pretorius  
>> >> wrote:
>>
>> >> > Marcel,
>>
>> >> > How would that be different from sending bulk DMs - something I have
>> >> > been advised in the past is not something that Twitter condones.
>>
>> >> > Here's the scenario.
>>
>> >> > MarketerMario has 2,000 followers. He creates four lists and adds 500
>> >> > of his followers to each list. Now he can send, with four simple
>> >> > clicks, his tweet whitening affiliate link to all his followers.
>>
>> >> > Dewald
>>
>> >> > On Nov 10, 2:19 pm, Marcel Molina  wrote:
>> >> >> That is indeed an interesting idea that we've been thinking about. The
>> >> >> rules around who can send and receive DMs would continue to be
>> >> >> enforced as normal, so for talking purposes, if you DMed a list, only
>> >> >> those who follow you would receive it.
>>
>> >> >> On Tue, Nov 10, 2009 at 9:21 AM, Marcus Better  
>> >> >> wrote:
>>
>> >> >> > -BEGIN PGP SIGNED MESSAGE-
>> >> >> > Hash: SHA1
>>
>> >> >> > Hi,
>>
>> >> >> > have you considered adding a mechanism for sending a sort of "direct
>> >> >> > message" to a list?
>>
>> >> >> > This would allow users to send targeted tweets to a list (provided 
>> >> >> > the
>> >> >> > user is a member of the list). It could be incredibly useful. For
>> >> >> > example tweets on a specific topic could be targeted to a selected
>> >> >> > interest group, without bothering your general followers.
>>
>> >> >> > Currently the only granularity provided is "whole world" (tweet) and
>> >> >> > "single recipient" (direct message), but this would allow new use 
>> >> >> > cases,
>> >> >> > for example something similar to a mailing list.
>>
>> >> >> > Cheers,
>>
>> >> >> > Marcus
>> >> >> > -BEGIN PGP SIGNATURE-
>> >> >> > Version: GnuPG v1.4.10 (GNU/Linux)
>> >> >> > Comment: Using GnuPG with Mozilla -http://enigmail.mozdev.org
>>
>> >> >> > iEYEARECAAYFAkr5oQUACgkQXjXn6TzcAQk+PgCfemGcdxyqZZrg1tNsxTWhna39
>> >> >> > gdAAoLJZHsM8yIqxzpHMp3XlYue2ODpz
>> >> >> > =ARYR
>> >> >> > -END PGP SIGNATURE-
>>
>> >> >> --
>> >> >> Marcel Molina
>> >> >> Twitter Platform Teamhttp://twitter.com/noradio
>>
>> >> --
>> >> Marcel Molina
>> >> Twitter Platform Teamhttp://twitter.com/noradio
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: /statuses/retweets_of_me resource does not have the retweet_status element

2009-11-11 Thread Marcel Molina

I believe in this case the documentation is just incorrect. The status
timeline of retweets_of_me is my original tweets that have been
retweeted. I'll update the docs to reflect that.

On Tue, Nov 10, 2009 at 7:11 PM, Michael Ivey (@ivey)
 wrote:
>
> Marcel, et al
>
> I'm working on bringing our Retweet-commerce tools up to date with the
> new RTs, now that they're rolling out, and we've got an issue.
>
> /statuses/retweets_of_me is returning just the statuses, without a
> retweet_status element to tell me who did the retweet. Is this a doc
> issue, or a bug?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: GET list members/subscribers - variant that returns ids only?

2009-11-11 Thread Marcel Molina

This has been brought up before and is on the list of things to
implement. Thanks for the suggestion.

On Wed, Nov 11, 2009 at 12:11 AM, Steve Farrell  wrote:
>
> The social graph methods that return a list of ids are very simple and
> efficient.  For example: 
> http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-friends%C2%A0ids.
>
> Are there plans for offering analogous queries for Lists?  The
> existing functions for paging through user *objects* using cursors is
> considerably less efficient when you simply are looking for ids.
>
> Thanks!
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: GET list members/subscribers - variant that returns ids only?

2009-11-11 Thread Marcel Molina

Yup. Ids everywhere of everything!

On Wed, Nov 11, 2009 at 11:23 AM, Steve Farrell  wrote:
>
> That's great news!
>
> An analogous request: how about getting a set of list ids instead of
> list objects for subscriptions/memberships?
>
> On Nov 11, 11:18 am, Marcel Molina  wrote:
>> This has been brought up before and is on the list of things to
>> implement. Thanks for the suggestion.
>>
>> On Wed, Nov 11, 2009 at 12:11 AM, Steve Farrell  wrote:
>>
>> > The social graph methods that return a list of ids are very simple and
>> > efficient.  For 
>> > example:http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-friends%C2%A0ids.
>>
>> > Are there plans for offering analogous queries for Lists?  The
>> > existing functions for paging through user *objects* using cursors is
>> > considerably less efficient when you simply are looking for ids.
>>
>> > Thanks!
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Bad ssl certs on some servers for api.twitter.com/1 ?

2009-11-17 Thread Marcel Molina

Ops has been trying to track down this problem for a while. They
confirmed that all servers have the correct cert. The current
hypothesis is that there are some rogue servers that are being load
balanced to that we don't expect to be accepting api.twitter.com
traffic that do not have the correct cert. Sorry it's not fixed yet.
We hope we can figure it out soon as it's a blocker for the transition
of api traffic from twitter.com to api.twitter.com.

On Tue, Nov 17, 2009 at 7:41 AM, Mageuzi  wrote:
>
> I've been having this same issue when connecting to https://api.twitter.com.
> I would have thought that if it is a problem with my code, I would
> always get this error.  However, it is intermittent.  Most times it
> works, but a few times an hour I will get the error.  Also, I never
> have this problem with https://twitter.com.
>
>
> On Nov 15, 6:46 pm, John Adams  wrote:
>> On Nov 15, 2009, at 1:16 PM, Tim Haines wrote:
>>
>> > Hi there,
>>
>> > I'm doing some dev work and I'm getting occasional ssl errors when
>> > making calls against api.twitter.com/1.  The most recent was posting
>> > to favorites/create.
>>
>> > Is it possible some of the servers have bad certificates?  Or is it
>> > likely I'm doing something very wrong?
>>
>> All of our servers have the same certificates; We have had some people
>> report a similar issue before and we verified all of the certificates
>> at that time. I do know of people having validation issues when they
>> don't have current versions of OpenSSL, a current Root CA bundle, or
>> their code has problems processing chained SSL certificates.
>>
>> Which program are you using to make requests against api.twitter.com?
>> curl? Firefox?
>>
>> Twitter's SSL certs are issued by RapidSSL/Equifax.
>> Make sure you have the proper root CA certs installed.
>>
>> If you're using OpenSSL libraries directly, remember that OpenSSL
>> ships without any Root CA certs installed.
>>
>> Curl users will have similar problems as well -- you'll want to run mk-
>> ca-bundle to get the proper ca-bundle installed.
>>
>> The TTYtter developers have a script that pulls the current CA bundle
>> from Mozilla, here:
>>
>> http://www.floodgap.com/software/ttytter/mk-ca-bundle.txt
>>
>> -john
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Re: Retweets - where are they placed on timeline

2009-11-17 Thread Marcel Molina

Should appear as a new tweet with the time of the retweet, not the
original tweet creation time. That assumes though that no one else has
retweeted it to you yet. If someone else has then this additional
retweet won't appear in your timelines except for the
statuses/retweets/id resource that lists up to 100 retweets for a
given tweet. Duplicates are collapsed out of the other timelines.

On Tue, Nov 17, 2009 at 11:46 AM, Tim Haines  wrote:
> Hi guys,
> I'm wondering if anyone can clarify.
> The services I run often shown tweets that are several months old, and offer
> the RT button next to them.  If someone clicks to RT the tweet, how does the
> tweet get presented to people that aren't following the original tweeter?
>  Is it placed at the top of the timeline appearing as a new tweet, or is it
> placed at the time the original tweet was tweeted?  i.e. months ago, so
> likely to never be seen?
> If it would be placed months ago, it makes RT pointless for older tweets, in
> which case I'll switch to 'classic mode' RT's.
> Tim.



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Re: Retweets - where are they placed on timeline

2009-11-17 Thread Marcel Molina
As Tim mentioned, clients are empowered to uncollapse retweets if they'd like.

On Tue, Nov 17, 2009 at 12:37 PM, Dewald Pretorius  wrote:
>
> Marcel,
>
> This collapsing behavior is far from ideal and will cause people with
> busy timelines to completely miss retweets.
>
> Nobody is online 24x7, and if only the first retweet of an update is
> shown in a user's timeline, they will miss completely it if the first
> retweet happened several hours before they login and check their
> timeline.
>
> In other words, someone can retweet the same update while they are
> online and they still won't see it.
>
> From a Twitter-internal technical standpoint, new retweets are ideal
> because it eliminates a lot of duplication and accompanying processing
> and storage requirements.
>
> From a user's perspective, it is far from ideal.
>
> With old-style retweets, if I saw ten retweets of the same thing, I
> knew to check it out because obviously a lot of people felt it was
> something worth sharing with their followers. With the new retweets,
> I'm going to miss that completely. Even if I notice the first retweet,
> the "retweeted by" section may show only one or two people, and I
> won't know that the update was retweeted by twenty more people after I
> happened to look at it.
>
> In my irrelevant opinion, the new retweet feature is trying to fix
> something that was not broken.
>
> Dewald
>
> On Nov 17, 3:58 pm, Marcel Molina  wrote:
>> Should appear as a new tweet with the time of the retweet, not the
>> original tweet creation time. That assumes though that no one else has
>> retweeted it to you yet. If someone else has then this additional
>> retweet won't appear in your timelines except for the
>> statuses/retweets/id resource that lists up to 100 retweets for a
>> given tweet. Duplicates are collapsed out of the other timelines.
>>
>> On Tue, Nov 17, 2009 at 11:46 AM, Tim Haines  wrote:
>> > Hi guys,
>> > I'm wondering if anyone can clarify.
>> > The services I run often shown tweets that are several months old, and 
>> > offer
>> > the RT button next to them.  If someone clicks to RT the tweet, how does 
>> > the
>> > tweet get presented to people that aren't following the original tweeter?
>> >  Is it placed at the top of the timeline appearing as a new tweet, or is it
>> > placed at the time the original tweet was tweeted?  i.e. months ago, so
>> > likely to never be seen?
>> > If it would be placed months ago, it makes RT pointless for older tweets, 
>> > in
>> > which case I'll switch to 'classic mode' RT's.
>> > Tim.
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Re: Retweets - where are they placed on timeline

2009-11-17 Thread Marcel Molina
The retweet feature is currently rolled out to 50% of users. We
gradually ramping it up. Full availability should be soon unless
issues arise as we incrementally roll it out. Thanks for your
patience. It's awesome to have people ready to pull the trigger on
retweet.

On Tue, Nov 17, 2009 at 1:27 PM, Rich  wrote:
> Does everyone have access to the ReTweet beta now?  If not when is
> expected deployment.  I have a fully working ReTweet API
> implementation but I don't want to submit it to Apple until everyone
> has access to it.
>
> On Nov 17, 9:19 pm, Marcel Molina  wrote:
>> As Tim mentioned, clients are empowered to uncollapse retweets if they'd 
>> like.
>>
>>
>>
>>
>>
>> On Tue, Nov 17, 2009 at 12:37 PM, Dewald Pretorius  wrote:
>>
>> > Marcel,
>>
>> > This collapsing behavior is far from ideal and will cause people with
>> > busy timelines to completely miss retweets.
>>
>> > Nobody is online 24x7, and if only the first retweet of an update is
>> > shown in a user's timeline, they will miss completely it if the first
>> > retweet happened several hours before they login and check their
>> > timeline.
>>
>> > In other words, someone can retweet the same update while they are
>> > online and they still won't see it.
>>
>> > From a Twitter-internal technical standpoint, new retweets are ideal
>> > because it eliminates a lot of duplication and accompanying processing
>> > and storage requirements.
>>
>> > From a user's perspective, it is far from ideal.
>>
>> > With old-style retweets, if I saw ten retweets of the same thing, I
>> > knew to check it out because obviously a lot of people felt it was
>> > something worth sharing with their followers. With the new retweets,
>> > I'm going to miss that completely. Even if I notice the first retweet,
>> > the "retweeted by" section may show only one or two people, and I
>> > won't know that the update was retweeted by twenty more people after I
>> > happened to look at it.
>>
>> > In my irrelevant opinion, the new retweet feature is trying to fix
>> > something that was not broken.
>>
>> > Dewald
>>
>> > On Nov 17, 3:58 pm, Marcel Molina  wrote:
>> >> Should appear as a new tweet with the time of the retweet, not the
>> >> original tweet creation time. That assumes though that no one else has
>> >> retweeted it to you yet. If someone else has then this additional
>> >> retweet won't appear in your timelines except for the
>> >> statuses/retweets/id resource that lists up to 100 retweets for a
>> >> given tweet. Duplicates are collapsed out of the other timelines.
>>
>> >> On Tue, Nov 17, 2009 at 11:46 AM, Tim Haines  wrote:
>> >> > Hi guys,
>> >> > I'm wondering if anyone can clarify.
>> >> > The services I run often shown tweets that are several months old, and 
>> >> > offer
>> >> > the RT button next to them.  If someone clicks to RT the tweet, how 
>> >> > does the
>> >> > tweet get presented to people that aren't following the original 
>> >> > tweeter?
>> >> >  Is it placed at the top of the timeline appearing as a new tweet, or 
>> >> > is it
>> >> > placed at the time the original tweet was tweeted?  i.e. months ago, so
>> >> > likely to never be seen?
>> >> > If it would be placed months ago, it makes RT pointless for older 
>> >> > tweets, in
>> >> > which case I'll switch to 'classic mode' RT's.
>> >> > Tim.
>>
>> >> --
>> >> Marcel Molina
>> >> Twitter Platform Teamhttp://twitter.com/noradio
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] api.twitter.com SSL issue should be resolved now

2009-11-17 Thread Marcel Molina
After doing some righteous spelunking our ops team discovered a small
misconfiguration that was very likely the culprit of the intermittent
untrusted cert error people were getting when trying to hit
api.twitter.com over SSL. This should be all fixed now. To those who
reported the problem thank you. Please let us know if you still run
into it. We don't think you will be we want to make sure it's totally
fixed. Thanks to everyone who's been patient as we ferreted out this
subtle problem.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Retweets and the Public Timeline

2009-11-18 Thread Marcel Molina
They are intentionally removed from the user_timeline.

On Wed, Nov 18, 2009 at 9:11 AM, Tyson Lowery  wrote:
> I've noticed that with the new retweet feature, retweets no longer
> appear in the user_timeline API calls.  Is this intentional or is this
> a bug?   If it is a bug, any ideas on the expected fix date?  I
> noticed a lot of complaints about this searching on twitter (like
> "hey, retweets don't show up in my XYZ application!")
>
> If it is intentional, there is no longer a way to get public retweets
> using the developer API calls.  Unless I am missing something?  The
> only way I see to do this is through the retweet API calls which
> require an authenitcated user.
>
> Thanks for any help you can provide.  I'm trying to get all the
> information I can before I start sinking time into writing a fix for
> this for my application.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Lists now have descriptions

2009-11-18 Thread Marcel Molina
You can now add a description to a list. The resources for creating
and updating a list via the API now supports a "description" parameter
and list payloads will include it as well.

All the relevant documentation should be updated to reflect these additions:
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-list-id
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-POST-lists
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-POST-lists-id
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-DELETE-list-id
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-lists

Let us know if something seems amiss and we hope you enjoy!

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Re: Lists now have descriptions

2009-11-18 Thread Marcel Molina
I've forwarded this along to our i18n team to see what they say.

On Wed, Nov 18, 2009 at 4:54 PM, JinS  wrote:
> it's great!
> however it seems cannot accept other asian languages such as Korean.
>
> On Nov 19, 11:21 am, Marcel Molina  wrote:
>> You can now add a description to a list. The resources for creating
>> and updating a list via the API now supports a "description" parameter
>> and list payloads will include it as well.
>>
>> All the relevant documentation should be updated to reflect these 
>> additions:http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-list-idhttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-POST-listshttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-POST-lists-idhttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-DELETE-list-idhttp://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-lists
>>
>> Let us know if something seems amiss and we hope you enjoy!
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Retweet count in status

2009-11-18 Thread Marcel Molina
It's on the todo list.

On Wed, Nov 18, 2009 at 4:55 PM, Remy Sharp  wrote:
> I'm not sure if this has been covered already, so if it has please
> point me in the right direction (had a quick search too).
>
> Once piece of really valuable information on the user timeline against
> each status would be the retweet count.  Obviously doing this
> ourselves via API calls could be expensive (in terms of hits we're
> sending), so it makes sense if it were available in the API.
>
> I can see lots of use for having just the count in there, just as we
> have the favorited flag.
>
> Any chance it's coming?
>
> Cheers,
>
> Remy.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] List creation updated (needs description param)

2009-11-18 Thread Marcel Molina
The description parameter is not required to create a list.

On Wed, Nov 18, 2009 at 3:57 PM, David  wrote:
> I've been using the List api in my app, and just noticed that the POST
> method to /:user/lists.:format returned the correct response, but
> didn't actually create a list.
>
> I've been following this api document: 
> http://apiwiki.twitter.com/Twitter-REST-API-Method:-POST-lists
>
> What I did notice was that the Add New List ui on Twitter.com has a
> description field, and so I tried the same call with an additional
> post param "description", and it worked.
>
> The description param can be empty, but it is required to make this
> call work.  Might be a bug?
>
> Just a heads up for anyone who might be wondering.
>
> DC
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Re: Retweets and the Public Timeline

2009-11-18 Thread Marcel Molina
I don't believe so. Are you working on a javascript widget that makes
authentication hard? Why do you want to access it without
authenticating?

On Wed, Nov 18, 2009 at 1:29 PM, Tyson Lowery  wrote:
> Thanks for the response.
>
> Is there a way to get them without authentication?
>
> On Nov 18, 10:43 am, Marcel Molina  wrote:
>> They are intentionally removed from the user_timeline.
>>
>>
>>
>>
>>
>> On Wed, Nov 18, 2009 at 9:11 AM, Tyson Lowery  wrote:
>> > I've noticed that with the new retweet feature, retweets no longer
>> > appear in the user_timeline API calls.  Is this intentional or is this
>> > a bug?   If it is a bug, any ideas on the expected fix date?  I
>> > noticed a lot of complaints about this searching on twitter (like
>> > "hey, retweets don't show up in my XYZ application!")
>>
>> > If it is intentional, there is no longer a way to get public retweets
>> > using the developer API calls.  Unless I am missing something?  The
>> > only way I see to do this is through the retweet API calls which
>> > require an authenitcated user.
>>
>> > Thanks for any help you can provide.  I'm trying to get all the
>> > information I can before I start sinking time into writing a fix for
>> > this for my application.
>>
>> --
>> Marcel Molina
>> Twitter Platform Teamhttp://twitter.com/noradio
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Re: Retweets and the Public Timeline

2009-11-18 Thread Marcel Molina
That's a compelling point. I need to think about it. We're stripping
retweets out of user_timeline because clients that don't implement
retweet have the (likely) potential of creating a very confusing
experience for users. Removing retweets from the user_timeline at the
time seemed fine because clients could merge retweets in using the
retweet timelines if they wanted to. Use cases that didn't require
authentication weren't being thought about for that scenario.

On Wed, Nov 18, 2009 at 5:48 PM, Jeffrey  wrote:
> Not having retweets in the user_timeline represents a loss of
> functionality.
>
> With user_timeline you can get the tweets of any user using the "id"
> parameter, but there is no way to get the tweets of another user using
> home_timeline without being authenticated *as that user*.   So this
> limits the ability of applications to gather info for a user without
> requiring them to log in.   Before the retweet funcdtionality was
> added, "organic" retweets were of course visible.   The built-in
> retweets are not.
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] Retweet API launched to 100% of users

2009-11-19 Thread Marcel Molina
Back in August we announced plans to release the Retweet feature along with
an API to publish and consume retweets. Over the last few months we've been
gradually opening up the feature to more users as we performance test and
refine it. You can see some of the original announcement emails around
retweets here:
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/1e07e332ec3d449d#
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/08540da9d7d64c46#
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/3641a248d555da20#
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/46928276a4c78df2#

Today we've launched the feature to 100% of users. You can now consume
retweets via the /statuses/home_timeline resource, as well as all the
specialized retweet timelines. For backwards compatibility reasons we're
stripping retweets out of the friends_timeline resource as well as the
user_timeline resource. If you plan on implementing support for consuming
retweets from timelines, switch all instances of /statuses/friends_timeline
to /statuses/home_timeline.

All the relevant retweet documentation can be found here:
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweet
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-home_timeline
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweeted_by_me
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweeted_to_me
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweets_of_me
http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-retweets

To those implementing this feature in your clients, I'd suggest taking some
UI cues from what we've done on Twitter.com:
http://s3.amazonaws.com/twitter_production/differentiating-retweets.png

Notice how the retweet by @ablegrape of @wblakegray's tweet is clearly
differentiated from the surrounding tweets with a distinctive retweet icon
and the "Retweeted by" label along the bottom. This is just one way of doing
it. Use whatever interface you think makes sense. What's important is
communicating to your users that the tweet they are seeing was shared with
them by someone they follow so they don't get confused by seeing tweets in
their timeline from people they aren't following.

We're just getting started with the retweet feature but we're happy with
this initial v1 we pushed out. We're really looking forward to seeing how
everyone works with this new API.

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


[twitter-dev] French version of twitter.com launched: More translation strings now available

2009-11-19 Thread Marcel Molina
Twitter.com is now available in French: http://bit.ly/twitter-in-french

If you're looking to add a French version of your application, we've added
some of the translation
strings we're using to the translations page on the developer wiki:
http://apiwiki.twitter.com/Twitter-String-Translations

Hope some find it useful!

-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] Twitter List API not working?

2009-11-24 Thread Marcel Molina
We are aware of the description parameter being (unintentionally) mandatory
right now. We're working on a fix. Thanks.

On Tue, Nov 24, 2009 at 2:18 AM, alan_b  wrote:

> it is just me or everybody else as well? the List API seems down at
> the moment
>
> i tried to create a list using the API
>
> example:
> ---
> curl -u user:pass -d "name=friends"
> http://api.twitter.com/1/31337geek/lists.xml
>
> i've got a normal response
> ---
> 
> 
>  3780302
>  friends
>  @31337geek/friends
>  friends
>  
>  0
>  0
>  /31337geek/friends
>  public
>  .
> 
>
> and then i made a "index" call immediately:
> curl -u user:pass http://api.twitter.com/1/31337geek/lists.xml
>
> i got a empty list:
> -
> 
> 
> 
> 
> 0
> 0
> 
>
>
> did i call a wrong API? or the API is currently down?
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


Re: [twitter-dev] List creation updated (needs description param)

2009-11-24 Thread Marcel Molina
The list API requiring a parameter to create/update a list has been fixed
and should be deployed today or tomorrow. Thanks everyone who reported this.
Sorry about that...

On Wed, Nov 18, 2009 at 3:57 PM, David  wrote:

> I've been using the List api in my app, and just noticed that the POST
> method to /:user/lists.:format returned the correct response, but
> didn't actually create a list.
>
> I've been following this api document:
> http://apiwiki.twitter.com/Twitter-REST-API-Method:-POST-lists
>
> What I did notice was that the Add New List ui on Twitter.com has a
> description field, and so I tried the same call with an additional
> post param "description", and it worked.
>
> The description param can be empty, but it is required to make this
> call work.  Might be a bug?
>
> Just a heads up for anyone who might be wondering.
>
> DC
>



-- 
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio


  1   2   >