====================================
fix: in pracmatical usage, code representing status is very
import, so add 'code' key to "Required Keys" for "type" of
"success", "fail". See the table below
| ''Type'' | ''Description'' | ''Required Keys'' | ''Optional Keys'' |
|----------+--------------------------------------------------------+--------------------+-------------------|
| success | All went well, and (usually) some data was returned. | status, code, data | |
| | | | |
| fail | There was a problem with the data submitted, | status, code, data | |
| | or some pre-condition of the API call wasn't satisfied | | |
| | | | |
| error | An error occurred in processing the request, | status, message | code, data |
| | i.e. an exception was thrown | | |