API для разработчиков

Серверы

Список серверов

GET/servers

Серверы по убыванию живого онлайна. Подозрительные и скрытые администрацией в список не попадают.

Параметры

qstringquery

Часть названия или адреса

regionenumquery · world

world, cis, europe, america, latam, asia

min_playersintegerquery · 0

Не меньше стольких живых игроков

limitintegerquery · 50

До 500

offsetintegerquery · 0

Сдвиг для следующей страницы

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/servers?q=Public&limit=2"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/servers?q=Public&limit=2",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/servers?q=Public&limit=2",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Серверы

Сервер

GET/servers/{address}

Карточка сервера: онлайн, карта, флаги подозрительности, плагин, услуги на мониторингах и коннекты по дням.

Параметры

addressstringpath

ip:port сервера

daysintegerquery · 14

За сколько дней коннекты, 1–60

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Серверы

История онлайна

GET/servers/{address}/history

До 48 часов — каждая точка опроса, дальше — средние по часам.

Параметры

addressstringpath

ip:port сервера

hoursintegerquery · 24

Длина периода, 1–720

offset_hoursintegerquery · 0

Сдвиг окна назад: hours — прошлый период

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/history?hours=6"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/history?hours=6",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/history?hours=6",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Серверы

Когда играют

GET/servers/{address}/heatmap

Средний живой онлайн по дням недели и часам МСК.

Параметры

addressstringpath

ip:port сервера

daysintegerquery · 28

За сколько дней

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/heatmap"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/heatmap",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/heatmap",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Данные плагина

Игроки по данным плагина

GET/servers/{address}/players

Для серверов с плагином TrueBoost: игроки, новые и вернувшиеся по дням, удержание новых и клиенты. Без плагина — has_plugin: false.

Параметры

addressstringpath

ip:port сервера

daysintegerquery · 14

За сколько дней, 1–60

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/players"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/players",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/servers/46.174.50.220:27015/players",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Мониторинги

Рейтинг мониторингов

GET/monitors/ranking

Медиана коннектов в день по услугам, заявленный эффект и оценка TrueBoost.

Параметры

min_service_daysintegerquery · 3

Меньше наблюдений — в конце списка

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/monitors/ranking"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/monitors/ranking",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/monitors/ranking",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Мониторинги

Мониторинг

GET/monitors/{slug}

Один мониторинг: сайт, круг, вес.

Параметры

slugstringpath

Короткое имя мониторинга

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».

Мониторинги

Серверы на мониторинге

GET/monitors/{slug}/servers

Серверы с активными услугами на мониторинге и последние коннекты.

Параметры

slugstringpath

Короткое имя мониторинга

Ключ передаётся в заголовке X-Api-Key. Лимит — 60 запросов в минуту на ключ, при превышении ответ 429. Время — UTC в ISO 8601.

curl -H "X-Api-Key: $TB_KEY" \
  "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost/servers"

const res = await fetch(
  "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost/servers",
  { headers: { "X-Api-Key": process.env.TB_KEY } },
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://trueboost.emris-host.ru/api/v1/monitors/ms-boost/servers",
    headers={"X-Api-Key": os.environ["TB_KEY"]},
)
data = r.json()

Ответ появится здесь

Нажмите «Отправить».