Skip to main content

📌 Основное

Для корректной работы с API Inn-Book необходимо соблюдать следующие базовые требования:

  • Все запросы отправляются по адресу: https://restota.inn-book.com/v1
  • Каждый запрос обязан содержать заголовок Authorization с API-ключом. Формат заголовка: Authorization: Bearer your_api_key
  • Во всех запросах, где требуется взаимодействие с конкретным отелем, должен присутствовать параметр: "hid": 123
    Это внутренний ID отеля в системе Inn-Book.
    hid выдаётся OTA после того, как отель выполнит запрос createMatching — Передачи сопоставлений (см. раздел API на стороне OTA).

📥 Получение API-ключа

Чтобы получить API-ключ для интеграции:

  1. Перейдите/зарегистрируйтесь в Личный кабинет, раздел Основное на платформе Inn-Book.
  2. Заполните анкету с информацией о вашей системе.
  3. Получите API-ключ, который можно использовать во всех REST-запросах.
  4. В ЛК Inn-Book будет создан автоматически тестовый отель для настройки интеграции.

Примеры кода

Ниже приведены примеры кода на различных языках программирования, демонстрирующие использование API-ключа для аутентификации и взаимодействия с API Inn-Book.

JS​

const axios = require('axios');
const apiKey = 'your_api_key_here';
const config = {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
};
axios.get('https://restota.inn-book.com/v1/rooms', config)
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(`Error: ${error.response.status} - ${error.response.data}`);
});

Пример запроса на PHP с использованием API-ключа​

$apiKey = 'your_api_key_here'; // Ваш API-ключ Inn-Book
$ch = curl_init();

// Устанавливаем URL запроса
curl_setopt($ch, CURLOPT_URL, "https://restota.inn-book.com/v1/rooms");

// Получение ответа как строки
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Заголовки запроса
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  "Authorization: Bearer $apiKey",
  "Content-Type: application/json"
));

// Выполнение запроса
$response = curl_exec($ch);

if (curl_errno($ch)) {
  // Вывод ошибки при сбое запроса
  echo 'Error: ' . curl_error($ch);
} else {
  // Декодирование JSON-ответа
  $rates = json_decode($response, true);
  print_r($rates);
}

// Закрытие соединения
curl_close($ch);

✅ Этот код демонстрирует, как отправлять запрос к REST API Inn-Book с использованием API-ключа и получать данные о комнатах.