Skip to content

Информация об участнике программы лояльности

Метод используется для проверки, является ли клиент участником программы лояльности, и, если является, какой у него уровень участника.

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

Параметры

ПараметрОбязателен?Описание
shop_idДаAPI-ключ
shop_secretДаСекретный ключ API
identifierДаИдентификатор участника ПЛ

Запрос

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

shell
curl https://api.rees46.ru/loyalty/members/status?shop_id=...&shop_secret=...&identifier=...
javascript
r46('loyalty', 'status', '70000000000', function (response) {
  console.log(response);
}, function (error) {
  console.error(error);
});

Важно

Чтобы работал метод в JS SDK, необходимо активировать настройку, разрешающую выполнение этого метода с фронта. Для этого свяжитесь с поддержкой.

Ответ

Если клиент является участником программы лояльности и находится на одном из уровней ПЛ, кроме базового, ответ будет в таком формате:

json
{
  "status": "success",
  "payload": {
    "member": true,
    "level": {
      "name": "Gold",
      "code": "level_gold",
      "expiration_date": "2028-01-01"
    }
  }
}

Если клиент на базовом уровне программы лояльности, то ответ будет выглядеть так:

json
{
  "status": "success",
  "payload": {
    "member": true,
    "level": {
      "name": null,
      "code": null,
      "expiration_date": null
    }
  }
}

Если клиент не является участником программы лояльности, то ответ будет таким:

json
{
  "status": "success",
  "payload": {
    "member": false,
    "level": {
      "name": null,
      "code": null,
      "expiration_date": null
    }
  }
}

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

ПараметрОписание
successЗапрос выполнен успешно или нет
payload.memberФлаг, обозначающий, является ли клиент участником ПЛ или нет
payload.level.nameНазвание уровня программы лояльности
payload.level.codeУникальный код уровня программы лояльности
payload.level.expiration_dateСрок действия уровня программы лояльности, после которого будет выполнен его пересчет

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

json
{
  "status": "error",
  "payload": {
    "message": "Identifier is not valid"
  }
}