Skip to main content

Categories

Overview

The Categories operation allows clients to retrieve categories from suppliers. The returned fields include: code and name.

Request

The Request is structured to accommodate access information for the content retrieval.

Overview

The request that receives the Connector is a Task with essential information that allows it to execute the operation properly:

  • Access: Represents access credentials and related information required for a connection.
  • Operation: Operation to be executed.

Sample

{
"Task": {
"Access": {
"Code": 11111,
"User": "tgx",
"Password": "password",
"Urls": {
"Generic": "https://api.hotelsupplier.com/generic"
},
"Parameters": {
"maxResults": "50",
"cacheEnabled": "true",
"requestTimeout": "5000",
"preferredSupplier": "SupplierX"
}
},
"Operation": "Boards",
"Languages": [ "en" ],
"Platform": "HOTELTEST",
"Supplier": "HOTELTEST",
"SupplierGroup": "HOTELTEST"
}
}

Details

The object ContentRq represents the structure of the content request as expected by the supplier.

NameTypeDescription
TaskIdIntegerUnique identifier of the task, automatically assigned by the system.
SupplierStringSupplier code associated with the access.
SupplierGroupStringSupplier group associated with the access.
PlatformStringThe platform that this supplier belongs to.
OperationServiceOperationEnumOperation to be executed.
TimeoutStringMaximum time to wait for a supplier response before timing out.Specified as a timestamp string (e.g., "24:00:00" for 24 hours).
AccessAccessAccess information required for the operation, including API credentials, endpoints,and other integration-specific connection details.
Access/CodeIntegerThe unique code identifying the access configuration.
Access/UserStringThe username used for authentication with the supplier.
Access/PasswordStringThe password used for authentication with the supplier.
Access/ApiKeyStringThe API key used for authentication or authorization.
Access/UrlsUrlsThe URLs associated with the access configuration.
Access/Urls/BookStringThe URL used for booking operations.
Access/Urls/SearchStringThe URL used for Search operations.
Access/Urls/QuoteStringThe URL used for Quote operations.
Access/Urls/GenericStringA generic URL for additional operations.
Access/ParametersAccessParametersAdditional parameters related to the connection.
LanguagesList<Iso2LanguageEnum>Language codes for the operation, represented as a list of ISO 639-1 2-character codes (e.g., "en", "es").

Response

The response contains the mapped categories information.

Overview

The response provides a straightforward structure for mapping categories across multiple languages.

Sample

{
"Code": "2",
"Names": {
"en": "2 Stars"
}
}

Details

The AccumulativeCategory object represents the standardized structure of the mapped category element.

NameTypeDescription
CodeStringCode of the category.
NamesDictionary<Iso2LanguageEnum, String>Dictionary of category names by ISO 2 language.