API Documentation v1

Описание HTTP/WEBSOCKET API V1

Использование недокументированных endpoint'ов наказуемо блокировкой аккаунта

Получить API токен можно на странице API

https://luxardgambling.com/api

Base URL и версия

• Префикс всех REST-эндпоинтов: /api/v1 api

• Версия в ответах: "api_version": "v1"

Авторизация

Передавайте ключ воркера в заголовке:

Authorization: Bearer <worker_api_key>

Формат ответов

Успех:

{
  "api_version": "v1",
  "status": "success",
  "result": {}
}

Ошибка:

{
  "api_version": "v1",
  "status": "error",
  "error": "text"
}

Promos

Инструкции промокода

Инструкции промокода — это набор правил и параметров, которые определяют условия работы промокода для пользователя.

Инструкции используются для:

• настройки логики бонусов и фрибетов;

• гибкого изменения условий без изменения кода.

Каждый промокод может содержать несколько инструкций, которые применяются совместно.

addBalance - Добавляет баланс, принимает int, принимается значение в центах USD
freeBet - Количество бесплатных ставок юзера, принимает int
freeBetMoneyCount - Сумма фри бета, работает только с инструкцией freeBet, принимает int
freeSpins - Количество фри спинов
freeSpinsMoneyCount - Сумма каждого фри спина

описание Promo:

name	string	Название промокода
need_money_winback	boolean	Требуется ли отыгрыш бонусных средств
free_bet_enabled	boolean	Включён ли режим фрибета
promo_instructions	array	Список инструкций промокода

Список доступных инструкций и их описание можно получить через эндпоинт:

GET /promos/description

GET /api/v1/promos/description

Возвращает актуальный список инструкций для промокода

{
  "result": [
    {"instruction_name": "...", "instruction_description": "..."}
  ]
}

GET /promos/list

GET /api/v1/promos/list?search=promo_prefix

Ответ:

{
  "result": [ // Promo
    {
      "id": "...",
      "name": "...",
      "need_money_winback": true,
      "free_bet_enabled": true,
      "promo_instructions": [
        {"id": "...", "instruction_name": "...", "instruction_value": 0}
      ]
    }
  ]
}

PATCH /promos/{promo_id}

PATCH /api/v1/promos/:promo_id

Body

Тело полностью повторяет формат Promo. Переданные поля перезаписывают текущие значения.

{
  "name": "UPDATED_BONUS",
  "free_bet_enabled": true,
  "promo_instructions": [
    {
      "instruction_name": "addBalance",
      "instruction_value": 200
    }
  ]
}

Ответ:

{
  "name": "string",
  "need_money_winback": false,
  "free_bet_enabled": true,
  "promo_instructions": [
    {
      "id": "uuid",
      "instruction_name": "addBalance",
      "instruction_value": 200
    }
  ]
}

POST /promos/create

POST /api/v1/promos/create

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

Body

{
  "name": "WELCOME_BONUS",
  "need_money_winback": true,
  "free_bet_enabled": false,
  "promo_instructions": [
    {
      "instruction_name": "addBalance",
      "instruction_value": 1000 // 10 долларов
    },
    {
      "instruction_name": "freeBet",
      "instruction_value": 10 // на промо будет 10 фри бетов
    },
    {
      "instruction_name": "freeBetMoneyCount",
      "instruction_value": 1000 // каждый фри бет будет на 10 долларов
    }
  ]
}

Ответ

{
  "result": {
    // "Promo"
  }
}

Дубликат промо → {"error":"you already has this promo"}

GET /promos/{promo_id}

POST /api/v1/promos/:promo_id

Возвращает один промокод.

Ответ

{
  "result": {
    "id": "uuid",
    "name": "BONUS",
    "need_money_winback": true,
    "free_bet_enabled": false,
    "promo_instructions": [
      {
        "id": "uuid",
        "instruction_name": "addBalance",
        "instruction_value": 100
      }
    ]
  }
}

DELETE /promos/delete

DELETE /api/v1/promos/delete?promo_id=uuid

Удаление промокода.

Query

?promo_id=uuid

Ответ

{
  "result": null
}

Domains

GET /domains/check/:domain_id

GET /api/v1/domains/check/{domain_id}

Проверка домена, аналогично проверки домена на панели:

Ответ

{
  "result": {
    "enabled": false,
    "need_sleep": true // сообщение о том, что надо проверить домен через н минут
  }
}

GET /domains/landings/list

GET /api/v1/domains/landings/list

Получить список лендингов

Ответ

{
  "result": [
    {
      "id":4,
      "description": "landing desc..."
    }
  ]
}

POST /domains/add

POST /api/v1/domains/add

Создание нового домена.

Body

{
    "name": "example.com",
    "landing_id": 2,
    "modal_auth": true
}

Ответ

{
  "result": {
    "id": "uuidv4",
    "ns": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
  }
}

GET /domains/list

GET /api/v1/domains/list

Ответ

{
  "result": [
    {
      "id":"...",
      "name":"...",
      "ns":"...",
      "status":"...",
      "worker_id":"..."
    }
  ]
}

DELETE /domains/:domain_id

DELETE /api/v1/domains/:domain_id → {"result":{"deleted":true}} Пустой id → 400.

Supports

Content в структуре сообщений

Поле content содержит массив элементов сообщения. Каждый элемент описывает отдельный фрагмент контента и имеет свой тип.

Поля объекта content

Поле	Тип	Описание
type	number	Тип контента
message_data	string	Данные контента (формат зависит от типа)
should_notify	boolean	Нужно ли отправлять уведомление пользователю

"content": [
  {
    "type": 1,
    "message_data": "...",
    "should_notify": true
  }
]

Типы контента

type = 1 — Text

Текстовое сообщение.

{
  "type": 1,
  "message_data": "Здравствуйте! Ваша заявка принята.",
  "should_notify": true
}

• message_data — обычная строка UTF-8

• Может использоваться в чатах поддержки и системных сообщениях

---

type = 2 — Base64 Image

Изображение, передаваемое в формате Base64.

{
  "type": 2,
  "message_data": "iVBORw0KGgoAAAANSUhEUgAA...",
  "should_notify": false
}

• message_data — строка base64

• Используется для отправки скриншотов, подтверждений, изображений документов

• Размер и формат изображения ограничиваются серверной валидацией

---

type = 3 — System Notification

Системное уведомление, формируемое платформой.

{
  "type": 3,
  "message_data": "chat_created",
  "should_notify": true
}

• Используется для автоматических уведомлений

• Может не отображаться как обычное пользовательское сообщение

• Часто применяется для статусов, предупреждений и служебных событий

Важно

ВАЖНО!

• Клиент должен обрабатывать content как массив, а не одиночный объект

• Тип контента определяется полем type, а не контекстом сообщения

• В будущем могут добавлятся неизвестные типы сообщений, рекомендуется их игнорировать до официальной информации

^{GET /supports/messages}

GET /api/v1/supports/[email protected]

Ответ:

{
  "result": [
    {
      "content":[{"type":1,"message_data":"...","should_notify":true}],
      "receive_time":"RFC3339",
      "readed":false,
      "chat_id":"...",
      "sender_name":"...",
      "support_id":"..."
    }
  ]
}

POST /supports/send

POST /api/v1/supports/send

Body

{
  "user_login": "user",
  "text": "hello",
  "image": "base64"
}

Требование: нужно text или image. api Ошибки: невалидный JSON → 400, пустой контент → 400 {"error":"message can't be without content"}, invalid image → 400, user without chats → 500.

GET /supports/wallets

GET /api/v1/supports/wallets

Query

[email protected]

Ответ:

{
  "result": [
    {"crypto_network":"...","wallet":"..."}
  ]
}

WebSocket API

WebSocket используется для получения событий в реальном времени без необходимости постоянного опроса REST API.

Через WebSocket передаются:

• новые сообщения чатов и поддержки;

• события депозитов;

---

Подключение

WS /api/v1/ws/{api_key}

ВАЖНО!

• Для подключения используется api_key в query, а не Bearer-токен.

---

Поддержание соединения (Ping / Pong)

Для проверки активности соединения сервер периодически отправляет:

ping

Клиент обязан ответить:

pong

ВАЖНО!

• Если клиент не отвечает на ping, соединение может быть закрыто сервером.

Формат событий

Все события приходят в формате JSON и имеют единый верхнеуровневый контракт:

{
  "event_type": "string",
  "data": {}
}

Поле	Тип	Описание
event_type	string	Тип события, message_event, deposit_event
data	object	Payload события

Message events

События, связанные с сообщениями чатов и поддержки.

Общий формат

{
  "event_type": "message_event",
  "data": {
    "chat_id": "...",
    "message": {}
  }
}

• chat_id — идентификатор чата

• message_content — объект сообщения (см. раздел Messages / Content)

message_event (расширенный формат)

{
  "event_type": "message_event",
  "data": {
    "id": "uuid",
    "worker_id": "uuid",
    "user_id": "uuid",
    "user_login": "string",
    "user_country": "string",
    "message_content": {},
    "domain": "string",
    "created_at": "RFC3339"
  }
}

Deposit events

События успешных депозитов пользователя.

Формат события

{
  "event_type": "deposit_event",
  "data": {
    "id": "uuid",
    "user_id": "uuid",
    "user_login": "string",
    "user_country": "string",
    "user_promo": "top4ik",
    "user_promo_id": "uuidv4",
    "crypto_currency": "string",
    "token_amount": "string",
    "amount_cents": 0,
    "amount_usd": "string",
    "worker_percent": 0,
    "worker_amount_cents": 0,
    "worker_amount_usd": "string",
    "worker_id": "uuid",
    "domain": "string",
    "transaction_hash": "string",
    "closed_at": "RFC3339"
  }
}

Рекомендации

• Обрабатывайте event_type через switch / map, а не по структуре data

• Всегда отвечайте на ping

• В тимах, рекомендуется привязывать именно promo_id к вашим воркерам

Пример обработки (псевдокод)

ws.onmessage = (event) => {
  if (event.data === "ping") {
    ws.send("pong")
    return
  }

  const payload = JSON.parse(event.data)

  switch (payload.event_type) {
    case "message_event":
      handleMessage(payload.data)
      break
    case "deposit_event":
      handleDeposit(payload.data)
      break
  }
}

JavaScript (Node.js, ws)

import WebSocket from "ws";

const WORKER_KEY = process.env.WORKER_KEY;
const WS_URL = `wss://<host>/api/v1/ws/${WORKER_KEY}`;

function handleMessage(data) {
  console.log("message_event:", data);
}

function handleDeposit(data) {
  console.log("deposit_event:", data);
}

const ws = new WebSocket(WS_URL);

ws.on("open", () => console.log("WS connected"));

ws.on("message", (raw) => {
  const text = raw.toString();

  // ping/pong (text frames)
  if (text === "ping") {
    ws.send("pong");
    return;
  }

  // events
  const payload = JSON.parse(text);

  switch (payload.event_type) {
    case "type_message":
      handleMessage(payload.data);
      break;

    case "type_deposit":
      handleDeposit(payload.data);
      break;

    default:
      console.log("unknown event_type:", payload.event_type);
  }
});

ws.on("close", () => console.log("WS closed"));
ws.on("error", (err) => console.error("WS error:", err));

Go (gorilla/websocket)

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/url"
	"os"

	"github.com/gorilla/websocket"
)

type Payload struct {
	EventType string          `json:"event_type"`
	Data      json.RawMessage `json:"data"`
}

func handleMessage(data json.RawMessage) {
	fmt.Println("message_event:", string(data))
}

func handleDeposit(data json.RawMessage) {
	fmt.Println("deposit_event:", string(data))
}

func main() {
	workerKey := os.Getenv("WORKER_KEY")
	u := url.URL{Scheme: "wss", Host: "<host>", Path: "/api/v1/ws/" + workerKey}

	c, _, err := websocket.DefaultDialer.Dial(u.String(), nil)
	if err != nil {
		log.Fatal("dial:", err)
	}
	defer c.Close()

	log.Println("WS connected:", u.String())

	for {
		_, msg, err := c.ReadMessage()
		if err != nil {
			log.Println("read:", err)
			return
		}

		text := string(msg)

		// ping/pong
		if text == "ping" {
			_ = c.WriteMessage(websocket.TextMessage, []byte("pong"))
			continue
		}

		var p Payload
		if err := json.Unmarshal(msg, &p); err != nil {
			log.Println("json:", err, "payload:", text)
			continue
		}

		switch p.EventType {
		case "type_message":
			handleMessage(p.Data)
		case "type_deposit":
			handleDeposit(p.Data)
		default:
			log.Println("unknown event_type:", p.EventType)
		}
	}
}

Java (OkHttp WebSocket)

import okhttp3.*;
import okio.ByteString;
import org.json.JSONObject;

public class WsClient {
  static void handleMessage(Object data) {
    System.out.println("message_event: " + data);
  }

  static void handleDeposit(Object data) {
    System.out.println("deposit_event: " + data);
  }

  public static void main(String[] args) {
    String workerKey = System.getenv("WORKER_KEY");
    String wsUrl = "wss://<host>/api/v1/ws/" + workerKey;

    OkHttpClient client = new OkHttpClient();
    Request request = new Request.Builder().url(wsUrl).build();

    WebSocketListener listener = new WebSocketListener() {
      @Override public void onOpen(WebSocket webSocket, Response response) {
        System.out.println("WS connected");
      }

      @Override public void onMessage(WebSocket webSocket, String text) {
        // ping/pong
        if ("ping".equals(text)) {
          webSocket.send("pong");
          return;
        }

        JSONObject payload = new JSONObject(text);
        String eventType = payload.optString("event_type");
        Object data = payload.opt("data");

        switch (eventType) {
          case "type_message":
            handleMessage(data);
            break;
          case "type_deposit":
            handleDeposit(data);
            break;

          default:
            System.out.println("unknown event_type: " + eventType);
        }
      }

      @Override public void onMessage(WebSocket webSocket, ByteString bytes) {
        // If server ever sends binary frames
        System.out.println("binary message len=" + bytes.size());
      }

      @Override public void onFailure(WebSocket webSocket, Throwable t, Response response) {
        System.err.println("WS error: " + t.getMessage());
      }

      @Override public void onClosing(WebSocket webSocket, int code, String reason) {
        webSocket.close(code, reason);
        System.out.println("WS closing: " + reason);
      }
    };

    client.newWebSocket(request, listener);
  }
}

Python (websocket-client)

import json
import os
import websocket

WORKER_KEY = os.getenv("WORKER_KEY")
WS_URL = f"wss://<host>/api/v1/ws/{WORKER_KEY}"

def handle_message(data):
    print("message_event:", data)

def handle_deposit(data):
    print("deposit_event:", data)

def on_message(ws, message: str):
    # ping/pong
    if message == "ping":
        ws.send("pong")
        return

    payload = json.loads(message)
    et = payload.get("event_type")

    if et in ("type_message"):
        handle_message(payload.get("data"))
    elif et in ("type_deposit"):
        handle_deposit(payload.get("data"))
    else:
        print("unknown event_type:", et)

def on_open(ws):
    print("WS connected")

def on_error(ws, error):
    print("WS error:", error)

def on_close(ws, code, reason):
    print("WS closed:", code, reason)

ws = websocket.WebSocketApp(
    WS_URL,
    on_open=on_open,
    on_message=on_message,
    on_error=on_error,
    on_close=on_close,
)
ws.run_forever()