Errors and Response Codes

The GrubOne APIs use HTTP response codes to communicate errors. A list of common errors encountered on the platform is listed below. As a general rule of thumb, a 4XX error is an issue on the client-side, and a 5XX is an error on GrubOne. This page contains links to troubleshooting Grutech APIs for errors and other issues that you may encounter when using APIs.

HTTP Status Codes

The Grubtech API attempts to return appropriate HTTP status codes for every request. In addition to descriptive error text, error messages contain machine-parseable codes. While the text for an error message may change, the codes will stay the same. Error codes in particular help in troubleshooting bad requests.

Most REST APIs follow a standard protocol for response headers. For example, 200 isn't just an arbitrary code decided upon by the OpenWeatherMap API developers. 200 is a universally accepted code for a successful HTTP request. (If you change the method, you will get back a different status code.)

HTTP Response Codes

These are general definitions codes and descriptions for response codes.

Success

HTTP Status CodeDefinitionMeaning
200Successful response OKIndicates that the server has successfully completed a HTTP request, and any information being returned is in the HTTP headers. No content as in a message body will be present.
204Successful response OKIndicates that the server has successfully completed a HTTP request, and any information being returned is in the HTTP headers. No content as in a message body will be present.

Failure

HTTP Status CodeDefinitionMeaning
400Bad requestThe server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing).
404Not foundAn HTTP status code that indicates that the server could not find the requested resource.
500Internal server errorA generic error message, given when an unexpected condition is encountered, and a more specific error message cannot be provided.