The documentation is bare. It's enough to use the API, but it doesn't tell you what the various codes and statuses mean. Also lacks info on how the overall process works, like after you place a trade then what? How do you know when your trade is complete?
There are a number of 3rd party wrappers around the API in the popular languages, but again you have to know how the exchanges function to do anything useful with them.
I'd gladly give a BC tip to someone who put together a useful guide to using the APIs in practice.