Открытие тикета

Требуется scope tickets:create. Игрок должен предварительно привязать Discord-аккаунт — см. «Привязка Steam ↔ Discord». Создание тикета — асинхронное: канал создаёт бот, а не API напрямую, так что ответ подтверждает только постановку в очередь (обычно занимает несколько секунд).

1. Список типов тикетов

GET /integration/dayz-api/v1/ticket-types
Authorization: Bearer <ваш_ключ>

Возвращает типы тикетов, настроенные администратором в панели — вам нужен конкретный id, «просто описание» без типа создать нельзя.

[
  { "id": "cmxxxxxxxxxxxxxxxxxxxxxxx", "categoryName": "Поддержка", "label": "Баг-репорт" },
  { "id": "cmyyyyyyyyyyyyyyyyyyyyyyy", "categoryName": "Поддержка", "label": "Жалоба на игрока" }
]

2. Создание тикета

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

userId — SteamID64 игрока.

{
  "typeId": "cmxxxxxxxxxxxxxxxxxxxxxxx",
  "message": "Застрял в текстуре на координатах 4200,7800"
}

message необязателен — если указан, попадёт отдельным полем в приветственный embed тикета.

Ответ 200

{ "queued": true }

Ошибки

  • 401 Unauthorized — ключ невалиден
  • 403 Forbidden — ключу не разрешён scope tickets:create, либо не активна подписка DayZ Plugin
  • 404 Not Found — SteamID не привязан к Discord, либо typeId не найден на этой гильдии