Document custom error body deserialization exception.

This is a less-than-ideal API but the behavior can't be changed because it's public API. We'll make error handling more robust in future versions.

Closes #527.

@swankjesse