Устройства

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

Обзор

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

GET /profile/devices

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

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

Query Parameters

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

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

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

Ответ

{
  status: true,
  statusCode: 200,
  data: {
    devices: Array<{
      id: number
      device_name: string
      device_type: string           // ios, android, windows, macos, linux
      os_version: string
      is_blocked: boolean
      is_fingerprinted: boolean
      last_seen_at: number          // Unix timestamp
    }>
    total: number
    page: number
    limit: number
    settings: {
      block_unknown_devices: boolean
      device_limit: number          // 0 = безлимит
    }
  }
}

GET /profile/devices/settings

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

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

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

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

Ответ

{
  status: true,
  statusCode: 200,
  data: {
    block_unknown_devices: boolean
    device_limit: number            // 0 = безлимит
  }
}

PATCH /profile/devices/settings

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

Rate Limit: 5 req / 1 sec

Request Body

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

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

curl -X PATCH "https://api.stealthsurf.app/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.

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	Да	Статус блокировки

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

curl -X PATCH "https://api.stealthsurf.app/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
}

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.app/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.app/profile/devices" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

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

Содержание