HTTP Status Codes

The HTTPush web service attempts to return appropriate HTTP status codes for every request.

200 OK: Success!
400 Bad Request: The request was invalid.  An accompanying error message will explain why. This is the status code will be returned during rate limiting.
401 Not Authorized: Authentication credentials were missing or incorrect.
404 Not Found: The URI requested is invalid or the resource requested, such as a recipient, does not exists.
500 Internal Server Error: Something is broken.  Please post to the group so the HTTPush team can investigate.
502 Bad Gateway: The HTTPush web service is down or being upgraded.
503 Service Unavailable: The HTTPush web service servers are up, but overloaded with requests.

We also return a message that contains an error explanation.

Sample JSON Error:

HTTP/1.1 500 Internal Server Error
Connection: close
Date: Thu, 30 Apr 2009 20:07:34 GMT
Content-Type: application/json
Content-Length: 58

{"error": "Whoops. Check status.httpush.com for details."}

Example XML Error:

HTTP/1.1 500 Bad Request
Connection: close
Date: Fri, 08 May 2009 08:07:04 GMT
Content-Type: application/xml
Content-Length: 109

<?xml version="1.0" encoding="UTF-8"?>
<errors>
  <error>Whoops. Check status.httpush.com for details.</error>
</errors>