Получение промокода из списка

Метод возвращает промокод для клиента.

GET https://api.rees46.ru/promo_codes/fetch

Параметры

Параметр	Обязателен?	Описание
shop_id	Да	API-ключ
shop_secret	Нет	Секретный API-ключ
id	Да	Идентификатор списка промокодов (числовой либо строковый)
did	Нет	Идентификатор устройства клиента из JS SDK
sid	Нет	Идентификатор сессии клиента из JS SDK

Важно

Метод работает в двух режимах:

1. Если есть shop_secret (запрос с бэкенда), то did и sid не нужны. Промокод просто выдается. Повторный запрос выдаст новый промокод.
2. Если нужно получать промокоды с фронта, то использовать shop_secret нельзя. Поэтому в JS SDK и мобильных приложениях метод получения промокода автоматически передает в запрос did и sid. Чтобы злоумышленник не мог выгрузить все промокоды из вашего списка, выданный промокод привязывается к клиенту, которому на данный момент принадлежит did и повторный запрос выдаст тот же самый промокод, если он не был использован в заказе.

Запрос

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

S2S

curl https://api.rees46.ru/promo_codes/fetch?shop_id=...&shop_secret=...&id=...

JS SDK

r46("get_promo_code", 
  {
    id: PROMOCODE_LIST_ID
  }, 
  success_callback, 
  error_callback
);

Ответ

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

{
  "code":  "UNIQUE_CODE"
}

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

Параметр	Описание
code	Выданный клиенту промокод

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

{
  "success": false,
  "payload": {
    "message": "Shop not found"
  }
}