After having much difficulty using the API classes from a programmatic standpoint, I've summarized my complaints into bug 10602:
http://bugzilla.wikimedia.org/show_bug.cgi?id=10602
If you have any thoughts, please feel free to post a comment there. :)
-- Jim R. Wilson (jimbojw)