We just had a heck of a time trying to find how to do a number of things using the Facebook API. We went through the Graph API, the JavaScript SDK and the PHP SDK, and couldn’t figure out why our code wasn’t working. We ended up finding the solution in the JSFL documentation on developers.facebook.com, and using the parameter in the JavaScript API.
What we discovered was that some, if not all of the parameters that are unlisted in one or more of the API sections can be used by the other versions of the API. For instance the following links all refer to the stream.publish API call, but not all have the property actor_id that allows you to post as a Facebook fan page.
http://developers.facebook.com/docs/reference/rest/stream.publish/
https://developers.facebook.com/docs/fbjs/streamPublish/
We are showing this because we have run into several examples of this throughout the Facebook API documentation. It resembles a game of broken telephone, where every time there is a new version of the API the new documentation is created but things get missed and forgotten, though they are still useful. So next time you are looking for something that you know is possible but can’t find it, remember to look at the other, older, and deprecated APIs to see if the parameter that you need is in there.
This is why I started http://fbdevwiki.com/ . Facebook used to have a wiki for documentation that allowed developers to make corrections in the docs when they found errors. Now, you can file a bug and have it ignored until that feature no longer exists.
So, I figured it was about time for a wiki run by the community.