Локации

Методы для получения списка доступных локаций серверов.

Обзор

Модуль для получения информации о доступных локациях VPN серверов.

GET /locations

Получить список всех доступных локаций серверов. Данные отдаются из Redis-кеша по ключу locations.

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

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

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

Ответ

{
  status: true,
  statusCode: 200,
  data: Array<{
    id: number              // Идентификатор страны
    code: string            // Код страны: DE, NL, US, RU и т.д.
    title: string           // Название страны
    description: string     // Описание страны
    caption: string         // Подпись страны
    is_active: boolean      // Активна ли страна
    ping_ip: string | null  // IP для пинга, null если не задан
    tags: string[]          // Теги локации, напр. ["virtual", "geo"]
  }>
}

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

{
  "status": true,
  "statusCode": 200,
  "data": [
    {
      "id": 1,
      "code": "DE",
      "title": "Германия",
      "description": "Франкфурт",
      "caption": "Низкая задержка для Европы",
      "is_active": true,
      "ping_ip": "185.123.45.67",
      "tags": ["virtual", "geo"]
    },
    {
      "id": 2,
      "code": "NL",
      "title": "Нидерланды",
      "description": "Амстердам",
      "caption": "Высокая скорость",
      "is_active": true,
      "ping_ip": null,
      "tags": []
    }
  ]
}

Если кеш пуст или повреждён, в data возвращается пустой массив с HTTP 200 — это штатный ответ, а не ошибка. Поле emoji хранится в кеше, но в ответе не отдаётся; если у локации нет тегов, tags приходит пустым массивом.

Ошибки

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