Skip to main content
Lampac NextGen предоставляет набор базовых HTTP- и WebSocket-эндпоинтов для проверки состояния сервера, геолокации, диагностики Playwright, ретрансляции данных через RCH и мониторинга внутренних метрик. Все эндпоинты описаны в разделе Core API.

Таблица эндпоинтов

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

Проверить идентификатор сборки

Ответ имеет тип text/plain. Запрос /version без type при включённом listen.version выполняет redirect и не является JSON health endpoint.

GeoIP-локация

string
Проверяемый адрес. Если не указан, используется IP текущего клиента.
string
ip возвращает только адрес, country — только код страны. Без параметра ответ JSON.
string
IP, для которого выполнена проверка.
string
Код страны из локальной базы GeoLite2.
В исходниках базы находятся в Core/data/, а в опубликованной сборке — в runtime-каталоге data/. Для GeoIP не требуется внешний API-ключ.

Статистика и мониторинг

Эндпоинты /stats/* предоставляют информацию о работе сервера в реальном времени:
  • /stats/gc — метрики памяти: размер кучи, WorkingSet, PrivateMemory
  • /stats/request — счётчики HTTP-запросов, число активных соединений, топ самых медленных маршрутов
  • /stats/tempdb — состояние внутренних кешей и пулов буферов
  • /stats/threadpool — диагностика пула потоков .NET
  • /stats/browser/context — состояние Playwright: активные контексты, счётчики страниц
Все /stats endpoints требуют openstat.enable: true и root authorization через cookie accspasswd или заголовок lcrqpasswd. При невыполненном условии сервер скрывает их ответом 404.

RCH-реле (Remote Client Hub)

Модуль RCH позволяет клиентам за NAT обмениваться данными через WebSocket-реле на сервере.
1

Включите RCH

Установите "rch": { "enable": true, "requiredConnected": 1 } в init.conf.
2

Отправьте результат

Используйте POST /rch/result?id=<id> для записи результата до 10 МБ или POST /rch/gzresult?id=<id> для сжатых данных.
3

Проверьте соединение

Вызовите GET /rch/check/connected; для NativeWebSocket используйте ws://<host>:9118/nws, если endpoint включён конфигурацией.

Core ping

Эндпоинт GET /api/chromium/ping всегда возвращает строку pong. Он подтверждает доступность Core, но не запускает Chromium и не доказывает исправность browser pool. Состояние Playwright проверяйте через /stats/browser/context и журнал запуска.
Last modified on September 2, 2026