+1
On 10/28/09 1:11 PM, "Jesse Stay" <jesses...@gmail.com> 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 <mar...@twitter.com> 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 >> >> > >