Skip to content

Список клиентов

Метод позволяет получить список всех клиентов определенной подписки.

GET https://api.rees46.ru/loyalty/subscriptions/members

Параметры

ПараметрОбязателен?Описание
shop_idДаAPI-ключ
shop_secretДаСекретный ключ API
subscriptionДаУникальный код подписки
planНетУникальный код плана (тарифа), как опциональный фильтр

Запрос

Пример запроса:

shell
curl https://api.rees46.ru/loyalty/subscriptions/members?shop_id=...&shop_secret=...&subscription=...&plan=...

Ответ

Пример ответа сервера:

json
{
  "success": true,
  "payload": {
    "message": "Successful request",
    "members": [
      {
        "identifier": "...",
        "subscription": "...",
        "plan": "...",
        "active": true,
        "paid_till": "...",
        "limits_reset_date": "..."
      },
      {
        "identifier": "...",
        "subscription": "...",
        "plan": "...",
        "active": false,
        "paid_till": "...",
        "limits_reset_date": "..."
      }
    ]
  }
}

Обратите внимание

Список будет содержать, в том числе, клиентов, у которых подписка уже просрочена. Не забывайте проверять поле paid_till или флаг active.

В случае ошибки ответ будет в формате:

json
{
  "success": false,
  "payload": {
    "message": "API secret is not correct"
  }
}

Расшифровка ответа:

ПараметрОписание
successЗапрос выполнен успешно или нет
payload.messageСообщение с результатом обработки запроса
payload.membersСписок клиентов на подписке (массив объектов)
payload.members[].identifierИдентификатор участника программы лояльности в формате 7XXXXXXXXXX
payload.members[].subscriptionУникальный код подписки
payload.members[].planУникальный код плана
payload.members[].paid_tillДата, до которой оплачена подписка
payload.members[].activeФлаг, активна подписка или нет
payload.members[].limits_reset_dateДата, когда будет выполнен следующий сброс лимитов