Errors
Error fields
The debug response field has information on your error.
{
"data": null,
"debug": {
"api_endpoint": {
"endpoint": "api/b2b/v3/hotel/info/",
"is_active": true,
"is_limited": true,
"remaining": 9,
"requests_number": 10,
"reset": "2018-08-16T12:12:37",
"seconds_number": 1
},
"api_key_id": 1304,
"method": "GET",
"real_ip": "62.76.100.3",
"request_id": "68c1141361db8c82835ea268486d7c6f",
"utcnow": "2018-08-16T12:12:36.328390"
},
"error": "decoding_json",
"status": "error"
}400
Invalid parameters
The error occurs if all required data isn’t passed. Check the validation_error field and pass the required data.
{
"data": null,
"debug": {
"api_endpoint": {
"endpoint": "api/b2b/v3/hotel/order/info/",
"is_active": true,
"is_limited": true,
"remaining": 9,
"requests_number": 10,
"reset": "2018-08-23T09:59:38",
"seconds_number": 1
},
"api_key_id": 1304,
"method": "POST",
"real_ip": "52.29.104.100",
"request_id": "7f4937bdabe8bb13d4980dcd77a16117",
"utcnow": "2018-08-23T09:59:37.495757",
"validation_error": "value \"page_number\" is required but None"
},
"error": "invalid_params",
"status": "error"
}Not allowed host
The error occurs if it is forbidden to request your host or IP.
ℹ️
To discuss a change to the permission, contact the API support team.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "7b76e52a742f714e6686761fab48cfa3",
"utcnow": "2018-08-23T11:31:44.235203"
},
"error": "not_allowed_host",
"status": "error"
}Unexpected method
The error occurs if the request was made using an unsupported HTTP method. Use the POST and GET methods instead.
{
"data": null,
"debug": {
"api_key_id": 1304,
"real_ip": "52.29.104.100",
"request_id": "19925f65c2763212bbe37294178b6fa6",
"utcnow": "2018-08-23T09:56:37.677774"
},
"error": "unexpected_method",
"status": "error"
}402
Overdue debt
The error occurs if you have an overdue debt.
ℹ️
Contact your account manager.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "36f4a2ae479cc0eba8e3ddf7d09bba14",
"utcnow": "2018-08-23T10:11:08.045023"
},
"error": "overdue_debt",
"status": "error"
}403
Authorization header
The error occurs if the request:
- Has no authorization header.
- Has invalid data in the authorization header.
The error response field can have the following values:
no_auth_header.invalid_auth_header.
ℹ️
Check the Authorization section.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "563c919d77000963a4ef9ade0988b21b",
"utcnow": "2018-08-23T10:03:28.794712"
},
"error": "no_auth_header",
"status": "error"
}Endpoint is not found
The error occurs if you don’t have permission to use the call.
ℹ️
To discuss a change to the permission, contact your account manager.
{
"data": null,
"debug": {
"api_key_id": 1775,
"method": "POST",
"real_ip": "10.11.0.23",
"request_id": "45141c733a1f4d534a0518c513d3641b",
"status": 403,
"utcnow": "2018-08-14T12:51:58.715639"
},
"error": "endpoint_not_found",
"status": "error"
}Incorrect API credentials or no permission to use endpoint
The error occurs if:
- You have used incorrect API credentials
- You don’t have permission to use the API.
ℹ️
In case of recurring unauthorized requests over a considerable period, the ETG may ban the IP address of sent requests.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "e6ff36a9e635825743e7ded8c05739a0",
"utcnow": "2018-08-23T09:34:43.673713"
},
"error": "incorrect_credentials",
"status": "error"
}Not allowed
The error occurs if your API key doesn’t have permission to use this API call.
ℹ️
To discuss a change to the permission, contact your account manager.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "7b76e52a742f714e6686761fab48cfa3",
"utcnow": "2018-08-23T11:31:44.235203"
},
"error": "not_allowed",
"status": "error"
}Endpoint is not active
The error occurs if the endpoint is deactivated.
ℹ️
To discuss a change to the activation, contact your account manager.
{
"data": null,
"debug": {
"api_endpoint": {
"endpoint": "api/b2b/v3/hotel/info/",
"is_active": false,
"is_limited": true,
"requests_number": 1,
"seconds_number": 20
},
"api_key_id": 496,
"method": "GET",
"real_ip": "10.11.0.23",
"request_id": "61c015d15d325f0bb945db5d027fc35c",
"utcnow": "2018-08-16T12:38:38.481018"
},
"error": "endpoint_not_active",
"status": "error"
}429
Limit is exceeded
The error occurs if you have exceeded the number of requests for an endpoint.
ℹ️
To discuss a change in the limit, contact your account manager.
{
"data": null,
"debug": {
"api_endpoint": {
"endpoint": "api/b2b/v3/hotel/info/",
"is_active": true,
"is_limited": true,
"remaining": -1,
"requests_number": 1,
"reset": "2018-08-16T12:32:40",
"seconds_number": 20
},
"api_key_id": 496,
"method": "GET",
"real_ip": "10.11.0.23",
"request_id": "8dd3efd24bdd6a9272770936e5108f8c",
"utcnow": "2018-08-16T12:32:26.161565"
},
"error": "endpoint_exceeded_limit",
"status": "error"
}Endpoint is locked
This error occurs if requests for an endpoint meet both conditions:
- Several requests use the same
partner_order_idfield value. - One request is sent twice within a short amount of time.
{
"data": null,
"debug": {
"real_ip": "52.29.104.100",
"request_id": "2c2264a2f3f64b9032624e99ddd49976",
"utcnow": "2018-08-23T11:43:27.101799"
},
"error": "lock",
"status": "error"
}5xx errors
Errors with the 5xx HTTP status code may occur. Typically due to a timeout in the ETG services. In this case, do both:
- Retry the request.
- Limit the number of repeated identical requests.
For these calls, refer to the descriptions of the call errors:
- Create booking process (B2B, Affiliate).
- Start booking process (B2B, Affiliate)).
- Check booking process (B2B, Affiliate).
Example of unknown error
The error occurs if something else has gone wrong.
{
"data": null,
"debug": null,
"error": "unknown",
"status": "error"
}