Отримання карти клієнта

URI: /api/v1/promotion/customer/{drugstore_id}/{number} - СТАРИЙ

URI: /api/v1/promotion/customer/search/{number} - НОВИЙ Search customer card

Метод використовується для отримання даних профілю покупця по номеру телефона або дисконтної картки покупця.

warning

Попередній метод Отримання карти клієнта підтримується але його використання не рекомендується.

Якщо використовуєте старий ендпоінт - замініть на новий (детальніше див. Search customer card)

Запит виконується методом GET.

⚠️ Запит повинен містити заголовок Accept: application/json

Параметри URI

URI запиту має містити змінні:

Ім'я	Тип	Обов'язковий	Опис
drugstore_id	string	Так	Ідентифікатор аптеки мережі
number	string	Так	Номер телефона або дисконтної картки покупця

Приклади запиту

Пошук по номеру телефона покупця

/api/v1/promotion/customer/969/380661234567

Пошук по номеру дисконтної картки покупця

/api/v1/promotion/customer/969/969000000013

Параметри відповіді

Ім'я	Тип	Опис
data	object	Дані клієнта
data.phone	string	Номер телефона клієнта
data.last_name	string	Прізвище клієнта
data.first_name	string	Ім'я клієнта
data.middle_name	string	Ім'я по батькові клієнта
data.city_name	string	Назва населеного пункту проживання клієнта
data.address	string	Адреса клієнта
data.address_post_code	string	Поштовий індекс клієнта
data.address_flat	string	Номер квартири/будинку клієнта
data.email	string	Адреса електронної пошти клієнта
data.birthday	string	Дата народження клієнта
data.gender	string	Стать клієнта: m - чоловік f - жінка
data.discount_card_number	string	Номер дисконтної картки клієнта
data.want_free_samples	boolean	Прапор згоди отримання безкоштовних зразків
data.contact_via_phone	boolean	Прапор згоди зв'язку через телефон
data.contact_via_sms	boolean	Прапор згоди зв'язку через СМС
data.contact_via_email	boolean	Прапор згоди зв'язку через електронну пошту
data.contact_via_messenger	boolean	Прапор згоди зв'язку через месенджери
data.agree_terms_conditions	boolean	Прапор згоди з правилами та умовами
data.phone_verified	boolean	Прапор підтвердження номера телефона клієнта
data.children	array	Список з роками народження дітей клієнта
data.loyalty	boolean	Прапор активної програми лояльності
data.loyalty_date	string	Строк дії програми лояльності
data.bonuses	float/double	Кількість бонусів на рахунку клієнта
data.type	object	Тип карти
data.type.id	string	ID типу карти
data.type.name	string	Назва типу карти

Приклад успішної відповіді

200 OK

Відповідь: /api/v1/promotion/customer/969/380661234567

{
  "data": {
    "phone": "380661234567",
    "last_name": "Іванов",
    "first_name": "Іван",
    "middle_name": "Іванович",
    "city_name": "Київ",
    "address": "вул. Кирилівська",
    "address_post_code": "04080",
    "address_flat": "63",
    "email": "[email protected]",
    "birthday": "1973-06-23",
    "gender": "m",
    "discount_card_number": "969000000013",
    "want_free_samples": true,
    "contact_via_phone": true,
    "contact_via_sms": true,
    "contact_via_email": true,
    "contact_via_messenger": true,
    "agree_terms_conditions": true,
    "phone_verified": true,
    "children": [
      1993,
      1995
    ],
    "loyalty": true,
    "loyalty_date": "2024-10-25",
    "bonuses": 0
    "type": {
      "id": NULL
      "name": NULL
    }
  }
}