Seems like the API is fine. The documentation and PHP implementation are your real complaints here. Amazon docs are always utter garbage, so no surprise there.
If it bothers you so much, get a 3rd-party lib and consume the web API directly.
The real title should be, "How not to support an API".