Why hasn't this been announced before? Why does the API suggest something totally different? At the very least, can you please hold off on deprecation of this until 2/11/2010? This is a new API change.
On Dec 23, 7:45 pm, Raffi Krikorian <[email protected]> wrote: > yes - if you do not pass in cursors, then the API will behave as though you > requested the first cursor. > > > > > Willhelm: > > > Your announcement is apparently expanding the changeover from page to > > cursor in new, unannounced ways?? > > > The API documentation page says: "If the cursor parameter is not > > provided, all IDs are attempted to be returned, but large sets of IDs > > will likely fail with timeout errors." > > > Yesterday you wrote: "Starting soon, if you fail to pass a cursor, the > > data returned will be that of the first cursor (-1) and the > > next_cursor and previous_cursor elements will be included." > > > I can understand the need to swap from page to cursor, but was pleased > > that a single call was still available to return (or attempt to > > return) all friend/follower ids. Now you are saying that, in addition > > to the changeover from page to cursor, you are also getting rid of > > this? > > > Can you please confirm/deny? > > > On Dec 22, 4:13 pm, Wilhelm Bierbaum <[email protected]> wrote: > > > We noticed that some clients are still calling social graph methods > > > without cursor parameters. We wanted to take time to make sure that > > > people were calling the updated methods which return data with cursors > > > instead of the old formats that do not. > > > > As previously announced in September (http://bit.ly/46x1iL) and > > > November (http://bit.ly/3UQ0LU), the legacy data formats returned > > > as a result of calling social graph endpoints without a cursor > > > parameter are deprecated and will be removed. > > > > These formats have been removed from the API wiki since September. > > > > You should always pass a cursor parameter. Starting soon, if you fail > > > to pass a cursor, the data returned will be that of the first cursor > > > (-1) and the next_cursor and previous_cursor elements will be included. > > > > If you aren't seeing next_cursor and previous_cursor in your results, > > > you are getting data back in the old format. You will need to adjust > > > your parser to handle the new format. > > > > We're going to start assuming you want data in the new format > > > (users_list / users / user or id_list / ids / id) instead of the old > > > format (users / user or ids / id) regardless of your passing a cursor > > > parameter as of 1/11/2010. > > > > * The old formats will no longer be returned after 1/11/2010. > > > * Start using the new formats now by passing the 'cursor' parameter. > > > > To recap, the old endpoints at > > > > /statuses/friends.xml > > > /statuses/followers.xml > > > > returned > > > > <users type="array"> > > > <user> > > > <!-- ... omitted ... --> > > > </user> > > > </users> > > > > or JSON like [{/*user record*/ /*, .../] > > > > whereas > > > > /statuses/friends.xml?cursor=n > > > /statuses/followers.xml?cursor=n > > > > return data that looks like > > > > <users_list> > > > <users type="array"> > > > <user> > > > <!-- ... omitted ... --> > > > </user> > > > </users> > > > <next_cursor>7128872798413429387</next_cursor> > > > <previous_cursor>0</previous_cursor> > > > </users_list> > > > > or, the JSON equivalent: > > > > {"users":[{/*user record*/} /*, ...*/], "next_cursor":0, > > > "previous_cursor":0} > > > > and the old endpoints at > > > > /friends/ids.xml > > > /followers/ids.xml > > > > returned data that looks like > > > > <ids> > > > <id>1</id> > > > <id>2</id> > > > <id>3</id> > > > </ids> > > > > whereas > > > > /friends/ids.xml?cursor=n > > > /followers/ids.xml?cursor=n > > > > return data that looks like > > > > <id_list> > > > <ids> > > > <id>1</id> > > > <id>2</id> > > > <id>3</id> > > > </ids> > > > <next_cursor>1288724293877798413</next_cursor> > > > <previous_cursor>-1300794057949944903</previous_cursor> > > > </id_list> > > > > or, the JSON equivalent: > > > > {"ids":[1, 2, 3], "next_cursor":0, "previous_cursor":0} > > > > If you have any questions or comments, please feel free to post them > > > to twitter-development-talk. > > > > Thanks! > > > > -- > > > Wilhelm Bierbaum > > > Twitter Platform Team > > -- > Raffi Krikorian > Twitter Platform Teamhttp://twitter.com/raffi
