Устройства

Методы для управления устройствами пользователя: просмотр, блокировка, удаление.

Обзор

Модуль для управления устройствами пользователя. Позволяет просматривать, переименовывать, подтверждать, блокировать и удалять устройства.

GET /profile/devices

Получить список устройств пользователя с пагинацией вместе с настройками устройств. Устройства отсортированы по last_seen_at по убыванию.

Rate Limit: глобальный (60 req/min)

Query Parameters

Parameter	Type	Required	Description
`page`	number	Нет	Номер страницы (нумерация с 1, минимум 1, по умолчанию: 1)
`limit`	number	Нет	Записей на странице (1-100, по умолчанию: 20)

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

curl -X GET "https://api.stealthsurf.net/profile/devices?page=1&limit=20" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: {
    devices: Array<{
      id: number
      title: string | null           // Пользовательское название устройства
      device_name: string | null    // "Неизвестное устройство", если определено по отпечатку
      device_type: string | null    // ios, android, windows, macos, linux
      os_version: string | null
      is_blocked: boolean
      is_approved: boolean          // Подтверждено ли устройство владельцем
      is_fingerprinted: boolean
      country: string | null
      city: string | null
      isp: string | null
      last_seen_at: number          // Unix timestamp
    }>
    total: number
    page: number
    limit: number
    settings: {
      block_unknown_devices: boolean
      device_limit: number          // 0 = безлимит
      require_approval: boolean     // Требовать подтверждение владельца для новых устройств
      force_ipv6: boolean           // Принудительно использовать IPv6 для доставки подписки
    }
  }
}

Ошибки

errorCode	message	Когда
2	user not found	Пользователь не найден

GET /profile/devices/settings

Получить настройки устройств.

Rate Limit: глобальный (60 req/min)

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

curl -X GET "https://api.stealthsurf.net/profile/devices/settings" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: {
    block_unknown_devices: boolean
    device_limit: number            // 0 = безлимит
    require_approval: boolean       // Требовать подтверждение владельца для новых устройств
    force_ipv6: boolean             // Принудительно использовать IPv6 для доставки подписки
  }
}

Ошибки

errorCode	message	Когда
2	user not found	Пользователь не найден

PATCH /profile/devices/settings

Обновить настройки устройств. Передаются только изменяемые поля, остальные сохраняют текущее значение.

Rate Limit: 5 req / 1 sec

При переключении block_unknown_devices с false на true все устройства, определённые по отпечатку (is_fingerprinted: true), будут удалены.

Request Body

Field	Type	Required	Description
`block_unknown_devices`	boolean	Нет	Блокировать приложения без заголовка `x-hwid`
`device_limit`	number	Нет	Лимит устройств (0-100, 0 = безлимит)
`require_approval`	boolean	Нет	Требовать подтверждение владельца для каждого нового устройства. Новые устройства без hardware ID отклоняются, уже подтверждённые продолжают работать
`force_ipv6`	boolean	Нет	Принудительно использовать IPv6 для доставки подписки

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

curl -X PATCH "https://api.stealthsurf.net/profile/devices/settings" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "block_unknown_devices": false,
    "device_limit": 5,
    "require_approval": false
  }'

Ответ

Такой же как GET /profile/devices/settings.

Ошибки

errorCode	message	Когда
2	user not found	Пользователь не найден

PATCH /profile/devices/:id/title

Переименование устройства.

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	Идентификатор устройства

Request Body

Field	Type	Required	Description
`title`	string	Да	Пользовательское название устройства (длина 1–64)

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

curl -X PATCH "https://api.stealthsurf.net/profile/devices/123/title" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Мой iPhone"
  }'

Ответ

{
  status: true,
  statusCode: 200,
  data: true
}

Ошибки

errorCode	message	Когда
40	device not found	Устройство не найдено

PATCH /profile/devices/:id/blocked

Заблокировать или разблокировать устройство. При разблокировке устройство автоматически помечается как подтверждённое (is_approved: true).

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	Идентификатор устройства (целое число)

Request Body

Field	Type	Required	Description
`is_blocked`	boolean	Да	Статус блокировки. Строка `"true"` приводится к `true`, любая другая строка — к `false`

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

curl -X PATCH "https://api.stealthsurf.net/profile/devices/123/blocked" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "is_blocked": true
  }'

Ответ

{
  status: true,
  statusCode: 200,
  data: true
}

Ошибки

errorCode	message	Когда
40	device not found	Устройство не найдено

PATCH /profile/devices/:id/approval

Подтвердить устройство, ожидающее одобрения. Устройство получает is_approved: true и is_blocked: false.

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	Идентификатор устройства (целое число)

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

curl -X PATCH "https://api.stealthsurf.net/profile/devices/123/approval" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: true
}

Ошибки

errorCode	message	Когда
40	device not found	Устройство не найдено

DELETE /profile/devices/:id

Удалить устройство.

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	Идентификатор устройства (целое число)

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

curl -X DELETE "https://api.stealthsurf.net/profile/devices/123" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: true
}

Ошибки

errorCode	message	Когда
40	device not found	Устройство не найдено

DELETE /profile/devices

Удалить все устройства.

Rate Limit: 1 req / 1 sec

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

curl -X DELETE "https://api.stealthsurf.net/profile/devices" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: number  // Количество удалённых устройств
}

Устройства

Содержание