Работа с онлайн-картами осуществляется через REST API.
В запросах не может быть указано более одной карты/номера телефона.
При запросе карты по номеру карты/телефона в ответ будет передаваться карта с клиентом, у которого заполнено поле personaloffer с актуальными на время запроса индивидуальными предложениями. Если для клиента не найдено ни одно актуальное индивидуальное предложение, то вернется пустое значение.
Поле lastKnownBonusBalance является устаревшим и больше не используется (см. Models->Карта->lastKnownBonusBalance).
Полный список всех возможных запросов может быть получен в Swagger UI.
Запросы поделены на группы по объекту, к которому они относятся.
Описание запросов для работы с онлайн-картами доступно по ссылке:
http://<IP адрес сервиса>:8096/swagger-ui.html
Подробнее о сервисе работы с онлайн-картами можно прочитать в разделе "Сервис работы с онлайн-картами".
Возможные ошибки
Если не найден клиент по телефону, то будет выдана ошибка:
Client with phonenumber <номер_телефона> not found.
Если найдено больше одного клиента, то будет выдана ошибка:
Found more than one client with phonenumber <номер_телефона>.
Если не найдена карта для клиента, то будет выдана ошибка:
No card found by phonenumber <номер_телефона>.
Если у клиента более одной активной карты, то будет выдана ошибка:
Found more than one card by phonenumber <номер_телефона>.
При получении карты по номеру телефона проверяется блокировка карты и ее статус.