Перейти к основному содержанию
Сервер имеет встроенный HTTP API для получения статуса и отправки команд удалённо. Здесь описывается этот API. По умолчанию этот HTTP API слушает тот же номер порта, что и игровой UDP-порт, но это можно изменить с помощью соответствующих CVars status.*.
Эта статья использует комментарии в JSON для упрощения описания. Это нестандартный JSON, он используется только для примера. Не используйте комментарии в JSON для реальных данных.
Контент может добавлять к этому свои API.

Публичный API (авторизация не требуется)

GET /status

Возвращает базовую информацию о статусе сервера в JSON, используется для отображения статуса в лаунчере SS14. Движок автоматически предоставляет следующую информацию:
// Примечание: комментарии обычно недопустимы в JSON, но здесь упрощают аннотирование.
{ 
    "name": "MyServer", // Имя сервера
    "players": 5, // Количество игроков на сервере
    "soft_max_players": 10, // Опционально, максимальное количество игроков на сервере.
    "tags": ["rp:low"], // Опционально, массив тегов (см. ниже стандартные значения)
}
Контент может редактировать эту информацию по своему усмотрению.

GET /info

Более детальная JSON-информация о сервере, в основном необходимая при подключении к серверу (для загрузки ресурсов и некоторых других вещей).
{
    "connect_addrees": "", // URI udp://, указывающий адрес UDP-подключения. Автоматически определяется как тот же порт, что и у API статуса, если не указан.
    "auth": {
        "mode": "Required", // Режим аутентификации. Может быть "Optional", "Required", "Disabled"
        "public_key": "", // Открытый ключ шифрования сервера для аутентификации. Использует API "sealed box" от libsodium.
    },
    "build": { // Информация о сборке для загрузки. См. ниже.
    },
    "desc": "My amazing server", // Опционально, общее описание сервера, отображаемое в лаунчере.
    "links": [ // Набор ссылок для отображения в лаунчере для этого сервера.
        {
            "name": "Discord", // Имя кнопки, отображаемой в лаунчере.
            "icon": "discord", // Иконка для этой кнопки, можно не указывать. См. ниже допустимые имена иконок.
            "url": "https://discord.gg/abcdef" // Ссылка, открываемая при нажатии кнопки. Должна быть http:// или https://
        }
    ],
    // Опционально, указывает информацию о политике конфиденциальности, с которой игроки должны согласиться.
    "privacy_policy": {
        // Ссылка, содержащая политику конфиденциальности, доступная через веб-браузер.
        "link": "https://example.com/privacy",
        // Идентификатор, который будет сохранён лаунчером при принятии.
        // ДОЛЖЕН БЫТЬ УНИКАЛЬНЫМ ДЛЯ КАЖДОГО СЕРВЕРНОГО СООБЩЕСТВА. НЕ КОПИРУЙТЕ ЕГО У ДРУГИХ.
        "identifier": "example",
        // «Версия» политики конфиденциальности. Должна быть изменена, если политика конфиденциальности сервера была обновлена.
        "version": "example"
    }
}
Подробнее об информации о сборке см. Advanced Server Build Configuration. Контент также может редактировать это по своему усмотрению.

API для Watchdog

Требует авторизации путём указания заголовка HTTP WatchdogToken, соответствующего CVar watchdog.token (автоматически устанавливается при использовании watchdog).

POST /shutdown

Указывает серверу немедленно корректно завершить работу.

POST /update

Указывает серверу, что доступно обновление, и он должен автоматически завершить работу как можно скорее, чтобы обновление было применено. Для SS14 это означает, что сервер перезапустится после окончания текущего раунда.

Иконки информационных ссылок

Вот допустимые иконки для links в API info:
  • discord
  • forum
  • github
  • web: Обычная иконка сайта
  • wiki

Стандартные теги

Это стандартные распознаваемые теги для поля tags в данных статуса. Лаунчер поддерживает фильтрацию и другие действия на основе этих тегов.

18+

Ваш сервер содержит контент 18+.

lang:

Указывает язык, используемый на вашем сервере, с помощью тега языка IETF. Примеры: lang:en для английского, lang:ru для русского и т.д. Вы можете указать несколько таких тегов для указания нескольких языков, если по какой-то причине вам нужен мультиязычный сервер. Вы можете указать более детальный тег языка IETF, например en-US, но лаунчер в настоящее время смотрит только на основной тег (например, en).

rp:none, rp:low, rp:med, rp:high

Указывает уровень RP (roleplay), ожидаемый на вашем сервере. Это очень субъективно.

region:

Указывает примерный код региона, чтобы помочь игрокам выбирать серверы, близкие к ним. Понимаются следующие коды:
CodeRegion
region:eu_wЗападная Европа
region:eu_eВосточная Европа
region:ataАнтарктида (мемный вариант)
region:grlГренландия (мемный вариант)
region:am_n_wСеверная Америка, Запад
region:am_n_cСеверная Америка, Центр
region:am_n_eСеверная Америка, Восток
region:am_cЦентральная Америка
region:am_s_sЮжная Америка, Юг
region:am_s_eЮжная Америка, Восток
region:am_s_wЮжная Америка, Запад
region:af_nСеверная Африка
region:af_cЦентральная Африка
region:af_sЮжная Африка
region:meБлижний Восток
region:as_nСеверная Азия
region:as_seЮго-Восточная Азия
region:as_eВосточная Азия
region:indИндия
region:oceОкеания
region:lunaЛуна (мемный вариант)
См. эту карту для приблизительного понимания, что куда относится: region_map_ss14.png Если для вашего региона нет подходящего варианта, сообщите нам!

no_tag_infer

Останавливает автоматическое определение тегов, см. ниже.

Определение тегов

Некоторые теги хаба автоматически определяются лаунчером на основе имени сервера. Это в основном предназначено для предоставления некоторых фильтров до того, как все серверы заполнят их вручную, поэтому если вы читаете это как хостер сервера, просто заполните свои теги вручную и можете игнорировать это. Правила следующие:
  • Если вы укажете no_tag_infer, определение тегов не выполняется вообще.
  • [18+] или [+18] автоматически добавляет тег 18+.
  • [NRP/LRP/MRP/HRP] автоматически добавляет соответствующий уровень RP в качестве тега, если у вас нет явного тега уровня RP.
  • [EN] и [RU] добавляют английский и русский в качестве тега соответственно, если у вас нет явного языкового тега.
Мы не будем добавлять дополнительные правила (например, определение других языков). Тегируйте свой сервер вручную.
Последнее изменение 21 июня 2026 г.