まあAPIのドキュメントなんてどこもこんなもんよね
SDKなんてのも大雑把だったりするし
curlサンプルでも載ってれば、まあ問題なく出来るやろって感じやな

ちょっと思ったがAPIに至ってはクラス図とかなんてのはユーザ(こちら)側の話であって
提供側が作るものではないのでは？

あとTwitterAPIのサンプルなら転がってるんじゃないかな、しらんけど