Различия

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

--- external:pro_bonus:10_probonus_api [2023/12/08 12:38] – Евгений Агеев
+++ external:pro_bonus:10_probonus_api [2024/12/16 15:24] (текущий) – Алексей Коробов
@@ Строка 5: / Строка 5: @@
   - Внешняя маркетинговая система (CRM) которая может получать данные по гостям из системы ProBonus и в свою очередь начислять на счета гостей бонусы и/или менять уровень скидки.
   - Внешние системы отчетов и аналитики, которые могут запрашивать данные из системы лояльности ProBonus.
+**Пример:**[[http://probonus.pro:6896/docs|http://probonus.pro:6896/docs]] - это экземпляр сервера ProBonus, развернутый на серверах ГК "Карбис".
+Админка (пользовательский интерфейс) доступен по адресу [[http://probonus.pro:6896|http://probonus.pro:6896]]
+Учетные данные для входа: admin / 111
 Полное описание API встроено в модуль ProBonus и доступно во вкладке ProBonus API
 {{ :external:pro_bonus:pasted:20231128-145235.png }}
 {{ :external:pro_bonus:pasted:20231128-145429.png }}
-**Пример:**[[https://saturn.carbis.ru:6896/docs|https://saturn.carbis.ru:6896/docs] - это экземпляр сервера ProBonus, развернутый на серверах ГК "Карбис".
-Админка (пользовательский интерфейс) доступен по адресу [[https://saturn.carbis.ru:6896|https://saturn.carbis.ru:6896]]
-Учетные данные для входа: admin / 111
 В данном разделе описаны основные (но не все) функции API и типовые сценарии работы с ним.
@@ Строка 24: / Строка 26: @@
   * **"Справочник скидок"** - чтение скидок полученных из RK, создание/модификация составных скидок/бонусов (лестниц)
   * **"Отчеты"** - чтение
+====Аутентификация====
+Аутентификация возможна через токен, который можно получить в разделе "Auth". (Если время жизни токена закончилось, аутентификацию нужно повторить, либо обновить через /api/v0/auth/refresh_token.)
+Для того, чтобы получить нужный "accessToken", в интерфейсе "Probonus API", нужно раскрыть на эндпоинт  /api/v0/auth/login и нажать "Try it out".
+{{ :external:pro_bonus:2024-03-04_15-24-45.png |}}
+Указать Логин и Пароль. Указать нужно в кавычках (вместо "string"), как показано в примере. После чего нажать на кнопку "Execute".
+{{ :external:pro_bonus:2024-03-04_17-33-32.png |}}
+Ниже откроется окно "Response body" в нём указан нужный токен. Его нужно скопировать без кавычек.
+{{ :external:pro_bonus:2024-03-04_17-42-37.png |}}
+Далее нужно нажать кнопку "Autorize" в шапке страницы и вставить скопированный токен, во всплывающем окне. После чего нажать дублирующую клавишу "Autorize", в этом же окне.
+{{ :external:pro_bonus:2024-03-04_15-25-37.png |}}