Устройства

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

Обзор

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

GET /profile/devices

Получить список устройств пользователя с пагинацией.

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

Query Parameters

Parameter	Type	Required	Description
`page`	number	Нет	Номер страницы (по умолчанию: 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_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 = безлимит
      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 = безлимит
    force_ipv6: boolean             // Принудительно использовать IPv6 для доставки подписки
  }
}

Ошибки

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

PATCH /profile/devices/settings

Обновить настройки устройств.

Rate Limit: 5 req / 1 sec

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

Request Body

Field	Type	Required	Description
`block_unknown_devices`	boolean	Нет	Блокировать неизвестные устройства
`device_limit`	number	Нет	Лимит устройств (0-100, 0 = безлимит)
`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
  }'

Ответ

Такой же как 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

Заблокировать или разблокировать устройство.

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	ID устройства

Request Body

Field	Type	Required	Description
`is_blocked`	boolean	Да	Статус блокировки (принимает boolean или строку `"true"`)

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

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	Устройство не найдено

DELETE /profile/devices/:id

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

Rate Limit: 5 req / 1 sec

URL Parameters

Parameter	Type	Required	Description
`id`	number	Да	ID устройства

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

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  // Количество удалённых устройств
}

Устройства

Содержание