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/v1"
PRO base URL:
"https://api.accor.com/catalog/"
UAT Example: "https://rec-api.accor.com/catalog/v1/catalog/v1.0/hotels/0911/products/accommodations"
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
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 REFERENTIAL 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 Accommodation
This service will provide you with all the informations available for all the accommodations of a specific hotel. You can find the labels of the codes used in this service in the ACCOR REFERENTIAL API.
"https://rec-api.accor.com/catalog/v1/hotels/{{HotelID}}/products/accommodations"
{
"accommodations": [
{
"configuration": [
{
"beddings": {
"singleBed": 1,
"doubleBed": 1,
"extra": {
"childBed": false,
"adultBed": false
},
"details": [
{
"type": "QUEEN_SIZE_BED",
"quantity": 1
}
]
},
"maxOccupancy": {
"pax": 2,
"adult": 2,
"children": 1,
"maxChildAge": 17
},
"situation": {
"accessibility": true,
"views": []
},
"assets": []
}
],
"id": "QED",
"label": "Classic Room with 1 Queen-size bed",
"shortLabel": "CLASSIQUE",
"extendedStay": false,
"classification": {
"type": "ROOM",
"standard": "CLASSIC"
},
"inventoryCount": 10.0,
"floorSpace": {
"value": 20,
"unit": "SQUARE_METER"
},
"amenities": [
{
"name": "FOOD_AND_BEVERAGE",
"facilities": [
{
"name": "FOOD_AND_BEVERAGE_FACILITIES",
"items": [
{
"code": "minibararMinib",
"name": "Mini Bar",
"paying": false
},
{
"code": "wateroomroomminerawate",
"name": "Free in Room Mineral Water",
"paying": false
},
{
"code": "coffeeteafaciliti",
"name": "Coffee/tea making facilities",
"paying": false
},
{
"code": "bottledwaterwat",
"name": "Bottled water",
"paying": false
},
{
"code": "fridge",
"name": "Fridge",
"paying": false
}
]
}
]
},
{
"name": "BATHROOM",
"amenities": [
{
"code": "TOILET_TYPE003",
"value": "Toilets in room, in bathroom"
},
{
"code": "PRIVATE_BATHROOM",
"value": "Private bathroom"
},
{
"code": "BATHIT",
"value": "Walk-in shower"
}
],
"facilities": [
{
"name": "BATHROOM_FACILITIES",
"items": [
{
"code": "accessiblebathroombath",
"name": "Accessible bathroom",
"paying": false
},
{
"code": "bathrobeobBathro",
"name": "Bathrobe",
"paying": false
},
{
"code": "hairdryerb",
"name": "Hair dryer in bathroom",
"paying": false
},
{
"code": "fulllengthmir",
"name": "Full-length mirror",
"paying": false
}
]
}
]
},
{
"name": "MEDIA_AND_TECHNOLOGY",
"amenities": [
{
"value": "phone"
}
],
"facilities": [
{
"name": "COMPLEMENTARY_ELEMENTS",
"items": [
{
"code": "multimediahubh",
"name": "Multimedia hub",
"paying": false
},
{
"code": "radio",
"name": "Radio",
"paying": false
}
]
},
{
"name": "PHONE_FACILITIES",
"items": [
{
"code": "voicemailma",
"name": "Voice mail",
"paying": false
}
]
},
{
"name": "INTERNET_FACILITIES",
"items": [
{
"code": "highspeedinte",
"name": "High speed internet",
"paying": false
},
{
"code": "internetconnectivitywifi",
"name": "Wireless internet in your room",
"paying": false
},
{
"code": "rj45outletoutl",
"name": "RJ 45 Outlet",
"paying": false
}
]
},
{
"name": "TV_FACILITIES",
"items": [
{
"code": "dtttvpackage",
"name": "DTT TV package",
"paying": false
}
]
}
],
"informationTv": {
"minimumSize": {
"code": "TVSIZE024",
"value": "48'/122 cm screen"
},
"technologies": []
}
}
],
"topAmenities": [
"Wireless internet in your room",
"High speed internet",
"Bathrobe",
"Coffee/tea making facilities",
"Mini Bar"
],
"medias": {
"total": 3,
"photos": [
{
"346x260": "https://www.ahstatic.com/photos/a7f3_roqed_00_p_346x260.jpg",
"1024x768": "https://www.ahstatic.com/photos/a7f3_roqed_00_p_1024x768.jpg"
},
{
"346x260": "https://www.ahstatic.com/photos/a7f3_roqed_01_p_346x260.jpg",
"1024x768": "https://www.ahstatic.com/photos/a7f3_roqed_01_p_1024x768.jpg"
},
{
"346x260": "https://www.ahstatic.com/photos/a7f3_roqed_02_p_346x260.jpg",
"1024x768": "https://www.ahstatic.com/photos/a7f3_roqed_02_p_1024x768.jpg"
}
]
}
},