Raise HTTP/JSON/API errors as exceptions

[kizzard]

Raise errors as exceptions

Type: Feature
Description: Raise HTTP/JSON/API errors as exceptions in order to make it more obvious what is going wrong. Related to #8

Implemented for methods:

• request_devices
• request_endpoints
• device_request

Handles:

• HTTP Status code errors
• Invalid JSON responses
• API errors received in JSON

Methodology:

1. Check if JSON can be decoded. If not:
   • Check for HTTP status code errors
   • Otherwise raise generic invalid JSON error (except for device_request, as blank response indicates success)
2. Check for API error in JSON response
   • JSON Errors come in two flavors, so method handles both types

Appendix:

API Error formats observed / handled:

1. {"error":true,"type":"{type}","message":"{message}"}
2. {"error":"{type}","error_description":"{message}"}

[dpjanes]

Can you make one change: jsonResponse -> json_response

[kizzard]

Done! Also changed errorType and errorMessage to use underscores too.

[dpjanes]

Cheers!