Hi All,
We are glad to announce that we are developing the 2.0 version of the Hyves-API with some great new functionality. We have developed a beta version and we would like to ask you to test this (for example in the console on http://www.hyves.nl/api/console/ ).
So what’s new?
- ha_returnfields, it’s possible to filter your output server-side, based on the very simple XML-Xpath. This limits the amount of kb’s of your result (that is especially important for mobile devices). You can specify what data you need to retrieve. For example with users.getFriendsByLoggedinSorted you could only retrieve the firstname, lastname and the userid, instead of all the standard fields ( see Returnfields for more information ).
- batch.process, it’s possible to batch your requests, for example making two API-calls where you could use the result of the first call in the second API-call. Especially in combination with the returnfields this can save you a lot of different calls and process time ( see batch process for more information ).
We have decided to name this the beta_2 version because we are aware that some of you are developing applications on our Experimental version, you have to know that we are planning to drop support on this version in a few months, so we ask you to test with the beta_2 version and move to the 2.0 version when it’s released. Please only use the stable versions in the future, because the experimental/beta versions can always be changed without any announcement, so don’t use this within a live or productionenvironment. New methods from the beta version will be moved to stable versions regularly. If however you find yourself in need of a method that hasn’t made it to a stable version yet, please send us an email to hyves-api[at]hyves[dot]nl explaining how and why you’d like to use that method, and we’ll see if we can speed up the process. Again, methods that are not in a stable version, are, well, not stable 
, so don’t count on them for anything but development.
There are some new methods, see full list below
- retrieving threads, for example threads.get
- add a spotted member, media.addSpotted
- add an OpenSocial type of gadget, gadgets.createByXML
- get the friends that are between the loggedin Hyver and a specific user, friends.getConnection
- retrieve the last public wwws of famous Hyvers (Artists, Politicians, Actors, etc), buzz.getFamous
- the method group hubs.* is added instead of the independent method groups like hangouts.* and groups.*. Within this method group it’s possible to also retrieve clubs, colleges, companies and schools (In the future we will add interests and brands as hub types).
- retrieve public wwws from all Hyvers, based on search terms like on our http://hyves.nl/nu/ page on the website, wwws.searchPublic
There are two methods with new parameters
- Blogs.create – add a blog to a hub with the hubid
- Wwws.create – add a www to a hub with the hubid (groupid hangoutid removed)
All new methods are listed below, we have added an explanation to some of them:
We have removed certain methods in version ‘beta_2’, most of them are replaced with hubs.* method group.
albums.getByHangout, blogs.getByHangout, hangouts.get, hangouts.getByUser, hangouts.getScraps, hangouts.getUsers, hangouts.getByShortname, hangouts.search, gadgets.getByHangout, groups.get, groups.getByUser, groups.search, groups.getScraps,groups.getUsers, groups.subscribe, groups.getByShortname, tips.getByHangout, users.getByHangoutLastlogin, wwws.getByHangout, albums.getByGroup, gadgets.getByGroup, blogs.getByGroup, users.getByGroupLastlogin, events.getByHangout,events.getByGroup
We have also changed the length of all the id’s within the API (only in the new version), this is changed from length 16 (as hex, 64 bit) to length 34 (as hex, 136 bit), for example the userid “8bddbdd6016a9656” is in the 2.0 version “0054e2e70a72538869018047cc45664b2f”. This is done with all API-ID’s. You can still use the old API-ID’s, but we would like to note that the old API-ID’s will not be supported forever. If for example you call the method ‘users.get’ within the 2.0 version with an old API-userid the result will be an userid with the new length. You could use the method users.get for the conversion of your id’s, you can provide multiple userid’s within this method (max. 1000 id’s).
We hope you will like the new features that we have build. If you run into any problems or if you have any suggestions you can report this at this blogitem or through hyves-api[at]hyves[dot]nl. Old versions will keep on working, we would like to note you on the methods that are deprecated in this version.
Regards,
Hyves-API team
