Главная/Документация/Разработчикам/DayZ API/Создание промокода

Создание промокода

Требуется scope dayz:promocodes:write.

POST /integration/dayz-api/v1/promocodes
Authorization: Bearer <ваш_ключ>
Content-Type: application/json

Тело запроса

{
  "name": "Стартовый набор",
  "code": "START2026",
  "quantity": 100,
  "deleteOnMaxUsage": true,
  "oneUsePerAccount": true,
  "allowList": [],
  "items": [
    {
      "id": "1",
      "type": "give_in_inv",
      "className": "AKM",
      "count": 1,
      "metrage": 0,
      "quantity": 1,
      "items": []
    }
  ]
}

Поля

Поле	Тип	Описание
`name`	string	Название промокода в панели (для админов, игроку не видно)
`code`	string	Код, который вводит игрок. Должен быть уникален для сервера
`quantity`	number	Максимальное количество использований
`deleteOnMaxUsage`	boolean	Удалить промокод после достижения лимита использований
`oneUsePerAccount`	boolean	Ограничить одним использованием на Steam-аккаунт
`allowList`	string[]	SteamID64, кому доступен код. Пустой массив — доступен всем
`items`	array	Список выдаваемых предметов, см. ниже

Элемент items[]

Поле	Тип	Описание
`type`	string	Один из: `give_on_ground`, `give_in_inv`, `give_kit_on_ground`, `give_kit_in_inv`
`className`	string	Classname предмета DayZ (реально существующий в игре — иначе спавн предмета молча провалится)
`count`	number	Сколько копий предмета выдать
`metrage`	number	Расстояние от игрока в метрах — только для `give_*_on_ground`
`quantity`	number	Состояние/заряд предмета при спавне
`items`	{key,value}[]	Вложения набора (classname'ы) — только для `give_kit_*`

Ответ 200

Возвращает созданный промокод — тот же объект, что отдаёт панель.

{
  "id": "cmxxxxxxxxxxxxxxxxxxxxxxx",
  "guildId": "...",
  "serverId": "...",
  "name": "Стартовый набор",
  "code": "START2026",
  "items": [ ... ],
  "quantity": 100,
  "uses": 0,
  "deleteOnMaxUsage": true,
  "oneUsePerAccount": true,
  "allowList": [],
  "status": "active",
  "createdAt": "2026-08-31T12:00:00.000Z"
}

Ошибки

400 Bad Request — код уже используется на этом сервере (должен быть уникален среди активных промокодов)
401 Unauthorized — ключ невалиден
403 Forbidden — ключу не разрешён scope dayz:promocodes:write, либо не активна подписка DayZ Plugin