Hotel options

Retrieve all descriptive content you need about a given hotel's options

Version
1.0.0
Status
Live
Incident
No incident

How to use it?

HTTP Methods

The API is accessible only through the Https protocol and only accepts HTTP GET requests.

It's made to retrieve information only – and not to modify it in any way.

UAT base URL: 

"https://rec-api.accor.com/catalog"

PRO base URL: 

"https://api.accor.com/catalog/"

UAT Example: "https://rec-api.accor.com/catalog/v1/hotels/3434/options"

HTTP Response codes

We use conventional HTTP response codes to indicate the success or failure of an API request.

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error.
  • Codes in the 5xx range indicate an server error.

Some 4xx errors that could be handled programmatically include an error code that briefly explains the error reported.

Squiggly Filter

Our API supports Squiggly, the Squiggly Filter is a Jackson JSON PropertyFilter, which selects properties of an object/list/map using a subset of the Facebook Graph API filtering syntax.

The easiest way to use this feature is to filter fields on the querystring like so:

  • ?fields=type,formats.format

Doc: https://github.com/bohnman/squiggly

HTTP ACCEPT-LANGUAGE

Our API supports, with certain qualifications, the ability to specify languages as part of an HTTP request, using the ACCEPT-LANGUAGE HTTP header. The Hotel options API honors this header where possible, selecting a language from the ACCEPT-LANGUAGE header and returning messages in that language.

When the ACCEPT-LANGUAGE header contains no language or a language that the API can't support, messages are returned in a default language, in this case it will be English.

Example

Using CATALOG Hotel Options

This service will provide you with the options informations of a hotel .

{
    "options": [
        {
            "id": "MPHB",
            "name": "Half Board",
            "medias": [
                {
                    "type": "IMAGE",
                    "formats": [
                        {
                            "format": "346x260",
                            "path": "https://www.ahstatic.com/photos/gpul_admphb_00_p_346x260.jpg",
                            "generic": true,
                            "lastUpdate": "2011-11-03T00:00:00+01:00"
                        }
                    ]
                }
            ]
        },
        {
            "id": "MBREAK",
            "name": "Breakfast",
            "description": "Start the day right with our sumptuous breakfast freshly prepared for you",
            "medias": [
                {
                    "type": "IMAGE",
                    "formats": [
                        {
                            "format": "346x260",
                            "path": "https://www.ahstatic.com/photos/gpul_admbreak_00_p_346x260.jpg",
                            "generic": true,
                            "lastUpdate": "2011-11-03T00:00:00+01:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Error example :

{
    "title": "HOTEL_NOT_FOUND",
    "status": "404",
    "detail": "The hotel does not exist",
    "requestId": "dc33f7a3-6958-4b8b-907b-843cf61072fb"
}

 

 

About us

We are far more than a worldwide leader. We are 300,000 hospitality experts placing people at the heart of what we do, and nurturing real passion for service and achievement beyond limits. We take care of millions of guests in our 5,000 addresses.