Blockchain.info API error handling

3

I've been working on a project involving use of the various Blockchain.info APIs (specifically the Blockchain Data API), and am wondering if anyone has tips regarding error handling: the API documentation says nothing about how errors are handled, and my experiments seem to indicate that errors are returned with HTTP status 200 and a strictly HTML response.

Has anyone implemented a client for this API and can shed some light on whether this is the "usual" state of affairs or a bug? Any additional tips would be greatly appreciated.

Tomer Gabel

Posted 2013-05-19T12:54:12.227

Reputation: 141

Answers

1

Error handling is not particularly well done. If you are specifying format=json errors should respond with status 500 and a text/plain message. But there may be errors HTML based errors as well.

If the response is not JSON parsable then it should be considered the server has encountered a generic error.

Ben Reeves

Posted 2013-05-19T12:54:12.227

Reputation: 2 848

1

I ended up implementing a response handler that implements the following heuristic:

  • If status code is 200 and Content-Type header is "application/json" (with or without charset), the response is valid.
  • If the status code is 200 or 500 (I've observed both) and the Content-Type header is "text/html" (with or without charset), the response is erroneous and the error message may be extracted with the following regular expression: (?s).*<div.*?class="alert alert-error">.*?<h4>(.*?)</h4>.*.
  • Otherwise the response is erroneous but the specific error message cannot be extracted.

This seems to work well in practice.

Tomer Gabel

Posted 2013-05-19T12:54:12.227

Reputation: 141

Asked: 2013-05-19T12:54:12.227

Viewed: 1 025 times

Active: 2013-05-25T17:41:14.733