Различия

Здесь показаны различия между двумя версиями данной страницы.

--- site:api [2021/09/16 14:41]
crs
+++ site:api [2022/06/20 08:35] (текущий)
crs [Поиск]
@@ Строка 8: / Строка 8: @@
 **Документация состоит из описания бизнес-процессов и технической части**
+===== ИЗМЕНЕНИЯ 24 декабря 2021 =====
+hotel/view объявлен устаревшим. Hotel/index возвращает аналогичные данные и позволяет делать меньшее кол-во запросов при интеграции (используя offset и limit = 1000)
+===== ИЗМЕНЕНИЯ 7 ноября 2021 =====
+Клиенты теперь могут видеть города и гостиницы респ. Беларусь (country id 15)
 ===== ИЗМЕНЕНИЯ 18 ноября 2020 =====
@@ Строка 271: / Строка 278: @@
 ===== Просмотр отеля / view =====
+**УСТАРЕЛ**!
+''Используйте hotel/index. Он возвращает данных в том же формате, обёрнутые в массив (для получения гостиницы в теле передайте json {"hotels":[86]}''
 Описание: Просмотр конкретной гостиницы (на тестовом сервере авторизация не требуется)
-Адрес: ''/api/hotel/view?id=86''
+Адрес: /api/hotel/view?id=86
-Метод запрос: ''GET\POST''
+Метод запрос: GET\POST
-Данные: ''id - номер гостиницы''. Параметр можно передавать как в URI, так и в теле запроса
+Данные: id - номер гостиницы. Параметр можно передавать как в URI, так и в теле запроса
 Возвращаемые данные: Модель гостиницы с номерами и ценами
@@ Строка 311: / Строка 322: @@
     "name": "Сибирь",//Название гостиницы
     "created_at": "1251955948",//Дата создания
-    "updated_at": "1563381026",//Дата последнего обновления
+    "updated_at": "1563381026",//Дата последнего обновления объекта
+    "last_modified": "1563381026", //Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
     "alias": "Park Inn by Radisson Ижевск, Парк Инн Рэдиссон Ижевск",//Псевдонимы через запятую. В основном нужно для гостиниц с англоязычным названием
     "active": "1",//Гостиница актуальная\работает
     "geo_lon": "44.5267469",//координаты
     "geo_lat": "48.7175457",
-    "child_updated": "1563381026", //актуальное время обновления любой зависимости по гостинице (цен, набора информации, маркапов клиента)
+    "child_updated": "1563381026", //DEPRECATED: тоже самое что last_modified
     "rooms": [//Набор номеров с ценами
         {
@@ Строка 646: / Строка 658: @@
             }
         ],
-        "last_modified": "1586234139",
+        "last_modified": "1586234139",//Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     }
@@ Строка 786: / Строка 798: @@
             }
         ],
-        "last_modified": "1550419709",
+        "last_modified": "1550419709", //Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     },
@@ Строка 938: / Строка 950: @@
             }
         ],
-        "last_modified": "1549605151",
+        "last_modified": "1549605151", //Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     },
@@ Строка 1052: / Строка 1064: @@
             }
         ],
-        "last_modified": "1549610129",
+        "last_modified": "1549610129", //Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     },
@@ Строка 1185: / Строка 1197: @@
             }
         ],
-        "last_modified": "1550570860",
+        "last_modified": "1550570860",//Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     },
@@ Строка 1242: / Строка 1254: @@
             }
         ],
-        "last_modified": "1553703900",
+        "last_modified": "1553703900",  //Дата последнего изменения объекта в целом (самой гостиницы или номеров, правил формирования цен и тд). Именно на этот параметр нужно смотреть, чтобы понимать актуальность данных
         "cancellation_rule": "за 48 часов до заезда - без штрафа, Менее 48 часов - на усмотрение гостиницы"
     }
@@ Строка 1989: / Строка 2001: @@
 ''client- id пользователя клиента (Вас). Если заявка заведена компанией Сусанин, то может отличаться от id вашего пользователя'',
+''status- массив id статусов заявок'',
 Параметры не обязательные, по умолчанию возвращаются все доступные пользователю заявки.