Различия

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

--- external:pro_bonus:10_probonus_api:01_scheme [2026/02/16 09:48] – [Типовые сценарии работы] Александр Ильин
+++ external:pro_bonus:10_probonus_api:01_scheme [2026/10/20 14:21] (текущий) – удалено Алексей Коробов
@@ Строка 1: / Строка 1: @@
-====== Типовые сценарии работы ======
-В зависимости от целей и задач которые преследует внешняя система во взаимодействии с системой лояльности ProBonus можно выделить несколько типовых сценариев интеграции.
-В данном разделе описаны базовые кейсы и указаны конкретные методы API необходимые для из реализации.
-Если требуемая вам логика взаимодействия не описана в данном разделе, вы можете написать нам на [[soft@carbis.ru]] и мы обязательно поможем найти решение.
-===== Авторизация для работы с API =====
-API ProBonus предусматривает два различных способа авторизации:
-  - Получение bearer токена через авторизацию (/api/v0/auth/login) и его дальнейшее  обновление (/api/v0/auth/refresh_token).
-  - Работа через токен для API. Все запросы в заголовках содержат постоянный токен.
-Поддерживаются оба варианта. Но вариант 2 проще и удобнее. В сваггере доступны оба варианта.
-{{:external:pro_bonus:10_probonus_api:pasted:20260216-093451.png}}
-===== Работа с анкетными данными на уровне ЛК внешней системы =====
-  - В качестве сквозного идентификатора гостя используем номер телефона.
-  - Если бизнес логика подразумевает создание новых счетов из внешней системы, тогда каждого нового гостя вы создаете в ПБ методом **/api/v0/accounts/insert_by_template**. \\ По минимум нужно передать только анкетные данные и телефон (email и доп идентификаторы - по желанию). Счет для гостя будет создан в группу accountGroupId и данному гостю будет автоматически назначена лояльность по шаблону настроенному для этой группы в рамках системы ProBonus (уровень, приветственные бонусы, установлено сгорание и т.п.) \\ Id нужной группы мы можете получить по API методом **/api/v0/account_groups/list**, или просто посмотреть в админке (http://probonus.pro:6896/account-groups/) и вынести в настройки на своей стороне. \\ **ВАЖНО:** Для корректного создания новых счетов по шаблону нужна группа с признаком «Шаблон для API» (haveTemplate=true). В тестовой БД это «Самостоятельно зарегистрировавшиеся» (id=3).
-  - Проверить гостя на существование в СЛ можно при помощи метода **/api/v0/accounts/find_by_phone**. Ищет гостя по номеру телефона. Если гость с указанным номером телефона существует, то в ответ вернется практически вся информация о нем: анкета, текущий остаток на счете, текущий уровень, купоны и так далее.
-===== Дополнительные методы API ProBonus =====
-  - **Начисление бонусов гостю** по инициативе внешней системы (например за какую то активность в вашем приложении). \\ /api/v0/accounts/refill.
-  - **Транзакции по счету** (показать в ЛК гостю его транзакции). \\ /api/v0/accounts/transactions – вернет все транзакции по счету за указанный период. \\ /api/v0/accounts/transactions – вернет N последних транзакций.
-  - **Обновить данные счета** (изменить анкету, изменить скидку/бонус, срок жизни бонусов и т.п.) \\ /api/v0/accounts/update
-  - **Получить данные конкретного чека** гостя (вплоть до блюд) \\ /api/v0/checks/get_by_id
-  - **Если используются сгорающие бонусы**. \\ /api/v0/accounts/get_balance_extended – вернет детализацию баланса счета, с указанием когда и сколько сгорит.