# Генерация купонов на продукты

Система защиты и лицензированния кода МИКО для 1С: API системы лицензирования

# API для генерации купонов на продукты

В системе представлена схема с описанием каждого поля, где указано его назначение.

Поле Описание поля
coupontype string
example: NewProduct
Тип купона: NewProduct или TrialExtend
couponscount integer
example: 1
Количество генерируемых купонов
usemanytimes integer
example: 0
Многоразовый купон (0 или 1)
distributorguid string
example: bdf28230-0708-11e6-b99b-005056940006
GUID Дистрибутора
crminvoice string
example: ЛА-012311
Номер счета
crminvoicedate string($date-time)
example: 2024-09-11
Дата счета
description string
example: Генерация из 1С
Комментарий к генерируемым купонам
products example: [{"guid":"9f3bbc89-e77b-11e4-b82f-0050568158a4", "multiplier": "1", "fixedexpire": "2028-09-11", "extenddays": 0}]
Массив продуктов для генерации купонов
{
guid
string
GUID продукта

multiplier
string
Множитель продукта

fixedexpire
string($date)
Дата истечения срока действия

extenddays
integer
Количество дней для расчета срока действия продуктва после активации купона
}

А также пример запроса со всеми заполненными полями.

Example Value
{
  "coupontype": "NewProduct",
  "couponscount": 1,
  "usemanytimes": 0,
  "distributorguid": "bdf28230-0708-11e6-b99b-005056940006",
  "crminvoice": "ЛА-012311",
  "crminvoicedate": "2024-09-11",
  "description": "Генерация из 1С",
  "products": [
    {
      "guid": "9f3bbc89-e77b-11e4-b82f-0050568158a4",
      "multiplier": "1",
      "fixedexpire": "2028-09-11",
      "extenddays": 0
    }
  ]
}

Помимо этого, доступны примеры ответов для каждого варианта.

Код Описание
200 Успешный ответ с массивом сгенерированных купонов
["MIKOUPD-GS6B5-XXXXX-AW0AN-XXXXX"]
400 Ошибка в запросе, неверные параметры
{"message": "Count must be bigger than 0"}
404 Ресурс не найден
{"message": "Unknown distributor GUID"}
500 Ошибка сервера
{"message": "Internal server error"}

Нажав на кнопку Try it out можно протестировать работу системы, указав значения полей.

Система защиты и лицензированния кода МИКО для 1С: API системы лицензирования