Errors

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

The error occurs if you try to request with the same value of the partner_order_id field more than once at the same 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 with HTTP status code 5xx may be returned. For example, because of the Emerging Travel Group services’ timeout. In this case, the request should be sent again and the number of recurrent identical requests must be limited.

In the case of the Order Booking Form (B2B, Affiliate, Order Booking Finish (B2B, Affiliate)), and Order Booking Finish Status (B2B, Affiliate) calls, use the recommendations left in the call descriptions.

Example of unknown error

The error occurs if something else has gone wrong.

{
  "data": null,
  "debug": null,
  "error": "unknown",
  "status": "error"
}