Reject Connection

This endpoint is used to decline an incoming connection request from a property that wishes to establish a channel integration.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/connection/rejectConnection 

-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json
Header
Type
Required
Description

app-id

string

Yes

Your application ID. Required for authentication.

Authorization

string

Yes

Your API key required for authorization.

Content-Type

string

Yes

Must be set to application/json.


Attributes

hotel_id string (Required)

Specifies the hotel ID for the property.


channel_hotel_id string (Required)

Specifies the channel-specific hotel ID for the property.


Sample Request

{
  "hotel_id": "new1",
  "channel_hotel_id": "12915670"
}

Response

Attributes

Status string

Indicates the result of the API call.

For example, Success or Fail.


Data object

Contains the main response data, such as property connection details.

An empty array if no data is found.


Message string

Descriptive message summarizing the API operation's outcome.

For example:

Connection Request Details Fetch Successfully, No Data Found


Ruid string

Unique request identifier for tracking, debugging, and logging.


Sample Success Response

{
  "Status": "Success",
  "Data": [],
  "Message": "Connection Request Rejected Successfully",
  "Ruid": "f4ef89ae-9de1-4eaa-bf74-10c05459b1f5"
}

Error

Sample Error Response 1

{
  "Errors": [
    {
      "Code": "400",
      "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
    }
  ],
  "Status": "Fail"
}

Sample Error Response 2

{
  "Errors": [
    {
      "Code": "573",
      "ShortText": "channel-mapping not found for this property!"
    }
  ],
  "Status": "Fail"
}

Sample Error Response 3

When error was thrown from booking.com

{
  "Status": "Fail",
  "Errors": [],
  "Message": "Data not found: Connection request not found",
  "Ruid": "f8e434cd-8191-4e82-bbf9-04e78cb9c86a"
}

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.


Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

ShortText string

A short description of the error.


Message string

A message providing more information about the error.


Ruid string

A unique identifier for tracking the request.

Last updated

Was this helpful?