URL для API

OTA формирует на своей стороне базовый URL для методов API, реализованных в системе InnBook, например:
- https://example.com/api/innbook/v1
- https://example.com/api_innbook.php

Авторизация

Все запросы, отправляемые Inn-Book в сторону OTA, содержат заголовок: Authorization: <ключ>
Inn-Book использует тот же API-ключ, который OTA получила при регистрации и использует при обращении к REST API. Таким образом, авторизация выполняется на основе одного и того же ключа как при обращении от OTA к Inn-Book, так и наоборот.
Зачем нужен этот заголовок:
- Это основной способ идентификации отправителя.
- Он подтверждает, что запрос действительно пришел от Inn-Book, а не от стороннего или злоумышленного источника.

Идентификация отеля

Каждый запрос от InnBook связан с конкретным отелем. Для этого в теле запроса передаётся объект auth, содержащий данные для авторизации/идентификации отеля:

"auth": {
  "hotelID": "123",
  "hotelKey": "112233"
}
		

Формат объекта auth определяется OTA по их собственному усмотрению. Настройка этих параметров доступна в личном кабинете в разделе "Основное -> Анкета OTA".
Установите нужные поля и их ключи при заполнении анкеты!

Формат запроса

Все запросы InnBook выполняет методом POST в формате JSON по ранее согласованному URL. Структура тела запроса следующая:

{
  "auth": { // Объект авторизации/идентификации отеля пример по ID
	"id":123
  },      
  "action": "method",   // Название вызываемого метода (см. документацию)
  "data": { ... }       // Набор данных, соответствующий конкретному методу
}