Errors
Ondato APIs use conventional HTTP response codes to indicate if the request was a success or a failure. These responses are unified; therefore, the format of the response will always be the same across all APIs.
HTTP status code summary
Code | Description | Description | Example value |
---|---|---|---|
| Bad Request | The request was unacceptable, which indicates that the given request parameters are invalid or missing required parameters. | "reason": "ValidationFailed",
"message": "The request is invalid.",
"params": {
"additionalProp1": [
{
"reason": "Required",
"message": "Property should not be empty."
}
]
} |
| Unauthorised | No valid access token provided. | "reason": "AuthenticationFailed",
"message": "The access token is missing, invalid, or is revoked." |
| Forbidden | The access token doesn't have permissions to perform the request. | "reason": "AuthorizationFailed",
"message": "The subject of the token does not have the permissions that are required to access the resource." |
| Not Found | The requested resource does not exist. |