Add clarification on usage of JSendMixin vs. APIError and return data patterns

[hfaran]

• As specified by this comment in Can't use @schema.validate and return error from get() method #63.
• Additionally, the cars example should be changed to use the return and raise APIError patterns rather than success/fail
  Can't use @schema.validate and return error from get() method #63 (comment)