The documentation was actually a bit deprecated...I have modified it to reflect the current state of the API. The test tool is always the best way to learn the actual resources on the REST API. Note, we will be adding more resources and even have some available that we may not be advertising as we're still finallizing exactly what data we want to make available by user launch.
One change you should note...we do not have a specific resource for /topfriends anymore. Instead, to get top friends you must provides a parameter on the .../friends resource of list=top. The value may also be online in order to retrieve the friends that are online and soon we will make a available a value of app for the friends using your application.