Таблица эндпоинтов
Примеры запросов
Проверить идентификатор сборки
text/plain. Запрос /version без type при включённом listen.version выполняет redirect и не является JSON health endpoint.
Штамп сборки
application/json. Поля ниже присутствуют в каждом ответе. semVer, baseTag, commits, gitBranch и commitDate равны null, если сборка собрана без git-метаданных.
version зависит от состояния репозитория на момент сборки:
- точный git-тег, префикс
vснимается:1.82.0; - есть коммиты после тега:
1.82.0-next+a952733a(8 символов SHA); - тега нет, ветка известна:
dev-feature-versioning+a952733a; - тега и ветки нет:
dev+a952733a; - репозитория нет: часть
InformationalVersionдо+, иначеunknown.
string
Постоянное имя сборки, то же значение, что у
type=name.string
Строка версии по правилам выше.
string
Короткий SHA (8 символов). Без git — фрагмент
InformationalVersion после +, либо null.boolean
true, если в рабочем дереве были незакоммиченные изменения. Без git — null, если метаданные сборки это не задали.string
Git ref сборки: аргумент
BuildRef, иначе GITHUB_REF, иначе refs/heads/{ветка}.string
URL репозитория из GitHub Actions или из git.
string
Ссылка на запуск CI, если сборка задала
GITHUB_RUN_ID.string
Время сборки в UTC, ISO 8601.
string
Конфигурация MSBuild, например
Release.string
Версия .NET SDK, которым собрали проект.
string
ОС сборочной машины.
string
Архитектура сборочной машины.
boolean
true, если рядом с процессом лежит файл isdocker.string
MD5 файла
Shared.dll. То же значение, что у type=hash и у assemblies.shared.hash.string
Описание runtime, например
".NET 10.0.0".string
Runtime identifier процесса, например
linux-x64.string
SemVer из GitInfo:
Major.Minor.Patch и суффикс, если он есть.string
Ближайший базовый git-тег.
string
Число коммитов после
baseTag. На точном теге это 0. Пустая строка приходит как null.string
Имя ветки. Для сборки без репозитория GitInfo не подставляет
main.string
Дата коммита из GitInfo.
object
Штампы сборок, которые процесс реально загрузил.
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 и журнал запуска.