Errors
In the event of a problem with your request you will receive an error response
As much as possible, Knowsis attempts to use the appropriate HTTP status codes to indicate the general class of problem. We will also provide a body to the request in the requested format with more details on the problem where available. You should handle errors in your application and present your end users with a more friendly response than the error messages provided here.
| Error Message | Description |
|---|---|
| 400 (Bad Request) | Any case where a parameter is invalid, or a required parameter is missing. This includes the case where OAuth parameters are not provided. |
| 401 (Unauthorized) | The OAuth signature was provided but was invalid. |
| 403 (Forbidden) | Access to the requested object was refused by the server. Your api account does not have permissions to access the request object. |
| 404 (Not Found) | The requested object does not exist. |
| 405 (Method Not Allowed) | Attempting to use POST with a GET-only endpoint, or vice-versa. |
| 409 (Conflict) | The request could not be completed as it is. Use the information included in the response to modify the request and retry. |
| 500 (Internal Server Error) | Our servers are having problems. The request is probably valid but needs to be retried later. |
Example error response body
{
"error": {
"errorCode": "400",
"errorMessages": [
"Missing parameter OAuth Consumer",
"Missing parameter OAuth Nonce",
"Missing parameter OAuth Signature"
]
}
}
The error object is made up of the following fields:
| Field | Type | Description |
|---|---|---|
| errorCode | integer | The relevant HTTP error code |
| errorMessages | list of strings | List of human readable error messages |
Additional details are provided in the errorMessages part of the error object. It should be one of the following types of errors.
| Error Message | Description |
|---|---|
| Missing OAuth parameter | The case where any of the required OAuth parameters are not provided. we will also specify the name of parameter that is missing. |
| Invalid OAuth Consumer | The provided OAuth Consumer key was not valid |
| Signature verification failed | The provided OAuth signature did not match that generated by the server. |