search

appdotnet / api-spec

App.net API Documentation is on the web at https://developers.app.net. Source for these docs is in the new-docs branch here. Please use the issue tracker and submit pull requests! Help us build the real-time social service where users and developers come first, not advertisers.
https://developers.app.net
950 stars 98 forks source link

REQ: Pagination for follower/following lists #98

Closed kosso closed 12 years ago

kosso commented 12 years ago

There is currently no pagination on https://alpha-api.app.net/stream/0/users/[user_id]/following|followers

This fails to consider the 'Scoble/Fry factor'. :)

kosso commented 12 years ago

The followers / following data supplied by the API very much needs to be ordered by 'date followed' and paginated.

Currently, even in these relatively early numbers, having a mobile download a list of a few hundred User objects at a time is proving to be unwieldy.

But the main issue is the random ordering which currently makes no sense to the developer or the end user of a client.

mthurman commented 12 years ago

We just rolled out a migration for this: https://github.com/appdotnet/api-spec/blob/master/migrations.md#current-migrations and https://github.com/appdotnet/api-spec/blob/master/resources/users.md#list-users-following-a-user

kosso commented 12 years ago

Thanks. Does it require the new data envelope too? (I'm assuming it does, to provide a 'more' value (if there are more))

Kosso

On 29 August 2012 02:33, Mark Thurman notifications@github.com wrote:

We just rolled out a migration for this: https://github.com/appdotnet/api-spec/blob/master/migrations.md#current-migrationsand https://github.com/appdotnet/api-spec/blob/master/resources/users.md#list-users-following-a-user

— Reply to this email directly or view it on GitHubhttps://github.com/appdotnet/api-spec/issues/98#issuecomment-8112875.

mxml-barmstrong commented 12 years ago

You don't need to have envelopes enabled in order to use the pagination parameters, but if you don't have them, it is up to you to figure out what the IDs are and whether there are more. As a result, it is highly recommended you use response envelopes.

kosso commented 12 years ago

No problem. Agreed. Make much more sense to do that first ;)

Thanks again.

On 29 August 2012 02:39, Brian Armstrong notifications@github.com wrote:

You don't need to have envelopes enabled in order to use the pagination parameters, but if you don't have them, it is up to you to figure out what the IDs are and whether there are more. As a result, it is highly recommended you use response envelopes.

— Reply to this email directly or view it on GitHubhttps://github.com/appdotnet/api-spec/issues/98#issuecomment-8112957.