Links

Errors

Eshopbox uses standard HTTP status codes to indicate the success or failure of an API request.
Code in the range of
2xx indicates success,
4xx indicates there was a problem with the request provided (e.g., a required field was missing)
5xx indicates an error occurred with Eshopbox API.

Example Errors

Here are some example error responses from the Eshopbox API.

Forbidden

You'll receive a 401: Unauthorized response when you provide an invalid access token
{
"error": {
"errors": [
{
"domain": "global",
"reason": "conditionNotMet",
"message": "401:Authentication failed: com.google.api.auth.UnauthenticatedException: No auth token is contained in the HTTP request"
}
],
"code": 412,
"message": "401:Authentication failed: com.google.api.auth.UnauthenticatedException: No auth token is contained in the HTTP request"
}
}

Bad Request

You'll get a 400: Bad Request when you fail validation.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "badRequest",
"message": "null value for parameter 'type' not allowed"
}
],
"code": 400,
"message": "null value for parameter 'type' not allowed"
}
}

Not Found

When a resource is not found you will get a 404: Not Found response
Not Found

Internal Server Error

You'll receive a 503: Internal Server Error response when something goes wrong on our side. We're automatically notified of these errors, and work to resolve them as quickly as possible.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "backendError",
"message": "backend error"
}
],
"code": 503,
"message": "backend error"
}
}
Unauthorized Error
You'll receive a 401Unauthorized Error response code when access Token has been expired. To resolve this error you have to regenerate the access token.
{
"message": "Expired token"
}
Unprocessable Entity
You'll receive a 422 unprocessbale entity error response code, when something missing or any validation fails in the request. To resolve this error please re-check the request and do the changes as per the error message.
{
"customerOrderNumber": [
"The customerOrderNumber has already been taken."
],
"items.0.itemID": [
"The items.0.itemID field is required."
],
"items.1.itemID": [
"The items.1.itemID field is required."
]
}