StealthSurf VPNStealthSurf VPN
Доступные методы

X-Ray ключи

Методы для генерации X-Ray X25519 ключей.

Обзор

Модуль для генерации криптографических ключей X-Ray X25519.


POST /xray/keys

Сгенерировать X-Ray X25519 пару ключей. Тело запроса не требуется — ключи генерируются вызовом бинарника static/xray x25519 на сервере.

Rate Limit: 1 req / 1 sec

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

curl -X POST "https://api.stealthsurf.net/xray/keys" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 201,
  data: {
    private_key: string    // Приватный ключ X25519 (Base64)
    public_key: string     // Публичный ключ X25519 (Base64)
  }
}

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

{
  "status": true,
  "statusCode": 201,
  "data": {
    "private_key": "YGxLOx7N9dFvlqJq5f3TxKqIYHVKxOJvqzVgZRJLGVE",
    "public_key": "BmQpY6j2VVlOv8RxXLHfTMQWblZOePgBgSF8K0iJDGw"
  }
}

Ошибки

errorCodemessageКогда
0access deniedЗаголовок Authorization отсутствует, API-ключ не найден или маршрут не разрешён для API-ключей (HTTP 401)
38user bannedВладелец ключа заблокирован (HTTP 403)

Ключи генерируются на сервере и возвращаются в Base64 формате. Используйте их для настройки Xray конфигурации.

Превышение лимита в 1 запрос в секунду возвращает HTTP 429 без поля errorCode. При инфраструктурном сбое (бинарник недоступен или вернул неожиданный формат вывода) возвращается HTTP 500 — это тоже не стандартная бизнес-ошибка.

Помогла ли вам эта статья?

Содержание