API Отелей

Endpoints для работы с данными отелей, номеров и их доступности.

Список отелей

GET /v1/hotels

Получение списка отелей с возможностью фильтрации.

Параметры запроса

Параметр	Тип	Описание
city	string	Город
stars	integer	Количество звезд
min_price	number	Минимальная цена
max_price	number	Максимальная цена
check_in	date	Дата заезда (YYYY-MM-DD)
check_out	date	Дата выезда (YYYY-MM-DD)
guests	integer	Количество гостей

Пример запроса

Поиск отелей в Архызе

curl -H "X-API-Key: your_api_key" \
     "https://api.arkhyz-club.ru/ota/v1/hotels?city=Архыз&stars=4&guests=2"

Пример ответа

Список отелей

{
  "data": [
    {
      "id": "hotel-123",
      "name": "Отель Архыз Горный",
      "address": "ул. Горная, 15, Архыз",
      "stars": 4,
      "description": "Уютный отель с видом на горы",
      "amenities": ["wifi", "parking", "restaurant", "spa"],
      "images": [
        {
          "url": "https://example.com/hotel1.jpg",
          "is_main": true
        }
      ],
      "location": {
        "latitude": 43.5847,
        "longitude": 41.2734
      },
      "min_price": 3500,
      "rating": 4.5
    }
  ],
  "total": 15,
  "page": 1,
  "per_page": 10
}

Данные отеля

GET /v1/hotels/{hotel_id}

Получение подробной информации об отеле.

Пример запроса

curl -H "X-API-Key: your_api_key" \
     "https://api.arkhyz-club.ru/ota/v1/hotels/hotel-123"

Номера отеля

GET /v1/hotels/{hotel_id}/rooms

Получение списка номеров отеля с ценами.

Пример ответа

Номера отеля

{
  "data": [
    {
      "id": "room-456",
      "hotel_id": "hotel-123",
      "name": "Стандартный номер",
      "description": "Уютный номер с видом на горы",
      "capacity": 2,
      "price_per_night": 3500,
      "amenities": ["wifi", "tv", "minibar"],
      "images": [
        {
          "url": "https://example.com/room1.jpg",
          "is_main": true
        }
      ],
      "availability": true
    }
  ]
}

Доступность номеров

GET /v1/hotels/{hotel_id}/availability

Проверка доступности номеров на определенные даты.

Параметры запроса

check_in (обязательный) - Дата заезда
check_out (обязательный) - Дата выезда
guests - Количество гостей

Пример запроса

curl -H "X-API-Key: your_api_key" \
     "https://api.arkhyz-club.ru/ota/v1/hotels/hotel-123/availability?check_in=2024-08-01&check_out=2024-08-07&guests=2"