Following some good feedback, I have created an RFC page detailing many changes to the new API.

Please add your suggestions and requests there.

http://www.mediawiki.org/wiki/Requests_for_comment/API_Future