Pushing changes to the API

4 views
Skip to first unread message

Duleepa Wijayawardhana

unread,
Jun 17, 2010, 6:07:00 PM6/17/10
to empireave-a...@googlegroups.com
I am about to push changes to the API to version 0.2

Note:

This is the final time that this API will change substantially without allowing for a grace period for apps to adjust to deprecated calls. I apologize that this is not being supported with this update, but we see this as going from an Alpha version to a Beta version. Any calls that are available now will remain. Any changes that reduce functionality will be communicated to application developers through these lists at least a couple weeks if it is minor. If it is major and likely to adversely affect your applications we will endeavour to have a grace period of at least a month so you can adapt your apps.

This does not apply to critical bugs which may require us to change at a moments notice.

From this moment, each call will also have a release notes section in the documentation should there be any changes. 

However, I am obliged to tell you that this is all in Beta and may contain bugs. Your apps should not be considered full production just as yet (not that all the calls are there anyway)

Here's what is changing in 5 mins:

Removed the following calls:

/profile/ticker (portfolio/base does the same thing)
/profile/categories (we no longer use categories)
/shouts/get (old commenting system no longer used)
/leaders/category (we no longer use categories)

Major Changes:

Calls with User ID are completely removed from the system
Many calls that retrieve many results (such as followers) are paginated and you have data such as "requested_page", "total_pages", "current_page", "next_page" to help you along

Additions and Changes

This is not the final list of additions this week. I will spam the announcement list as we add each new call but the following are being pushed up with this update:

Updated /leaders
- All calls now refer to "brands" as an endpoint rather than "sites" to reflect what is in the site

Added /leaders/dailyearnings (100 ranked in daily earnings)
Added /leaders/weeklyearnings (100 ranked in weekly earnings)
Added /leaders/dividends (100 ranked in weekly earnings)
Updated /leaders/wealth - now shows the correct wealth rankings
Updated /leaders/shareprice - lowest shareprice rankings have been removed

Added /profile/brands - retrieves a users brand lists
Added /profile/communities - retrieves a users community membership
Added /profile/counts - retrieves various numbers for a user
Added /profile/rankings - retrieves a users complete rankings (not community rankings)

Updated /profile/followers - paginated, contains ticker, last_trade
Updated /profile/following - paginated, contains ticker, last_trade
Updated /profile/info - retrieves some more fields see docs

Updated /search/recent - fetching 100 recent users and their join date.

There may be extra fields being returned in each call, please brows the docs at:




Reply all
Reply to author
Forward
0 new messages