Для владельцев серверов

1. 1Поставьте наш баннерБаннер или ссылка на L2Signal на вашем сайте — обязательное условие бесплатного размещения. Код — внизу страницы.
2. 2Добавьте серверЗаполните анкету: хроники, рейты, дата открытия, ссылки и страница, где стоит наш баннер.
3. 3Дождитесь проверкиМодератор проверяет заявку, обычно в течение суток. Сохраните ссылку правки: по ней меняете дату и описание, там же ключ API.
4. 4Зовите игроков голосоватьПоставьте кнопку «Голосуй» на свой сайт и выдавайте награду в игре — сервер поднимется в топе.

Бесплатно ваш сервер стоит в колонке по дате открытия. Чтобы его увидело больше игроков, есть три значка на 30 дней:

• Эксклюзив Большая карточка в самом верху главной с анимацией и отсчётом до открытия.
• Премиум Золотая карточка в ряду премиум-серверов, выше обычных в колонке.
• VIP Сервер поднят вверх своей колонки и выделен цветом.

Игрок голосует за ваш сервер на L2Signal и по желанию вписывает ник персонажа. Ваш игровой сервер спрашивает наш API, был ли голос, и сам выдаёт награду. Голосовать можно раз в 12 часов с одного IP.

Название сервера и ключ API — на вашей странице правки (ссылку вы получили после добавления сервера). Ключ держите в секрете: его можно перевыпустить там же.

Запрос

GET https://l2signal.ru/api/vote?server=ВАШ_СЕРВЕР&key=ВАШ_КЛЮЧ&nick=Ник&ip=1.2.3.4

• nick — ник персонажа, ip — IP игрока. Нужен хотя бы один; если указать оба, должны совпасть оба.
• hours — необязательно, за сколько часов искать голос (по умолчанию 12, максимум 48).
• Проверять лучше по IP или по паре «ник + IP»: ник игрок может вписать любой.

Ответ

{"voted":true,"at":1794675600000,"nick":"Grace"}
{"voted":false}

at — время голоса в миллисекундах (UTC). Запомните его у себя, чтобы не выдать награду за один голос дважды.

Пример: PHP

$url = "https://l2signal.ru/api/vote?server=" . urlencode($server) . "&key=" . urlencode($key)
     . "&nick=" . urlencode($nick) . "&ip=" . urlencode($ip);
$res = json_decode(@file_get_contents($url), true);
if (!empty($res["voted"]) && $res["at"] > $lastRewardAt) {
    // выдать награду персонажу $nick и запомнить $res["at"]
}

Пример: Java (L2J)

HttpClient http = HttpClient.newHttpClient();
String url = "https://l2signal.ru/api/vote?server=" + server + "&key=" + key
    + "&nick=" + URLEncoder.encode(player.getName(), StandardCharsets.UTF_8)
    + "&ip=" + player.getClient().getIp();
String body = http.send(HttpRequest.newBuilder(URI.create(url)).build(), BodyHandlers.ofString()).body();
if (body.contains("\"voted\":true")) {
    // выдать награду и запомнить время голоса
}

Ошибки: 403 bad_key — неверный ключ или сервер не опубликован, 400 — не указан ник/IP или они в неверном виде, 429 — слишком много запросов (больше 600 в минуту).

Поставьте кнопку на сайт или форум: игрок нажимает и сразу попадает к голосованию за ваш сервер. Вместо ВАШ_СЕРВЕР — адрес сервера у нас (из ссылки на его страницу).

<a href="https://l2signal.ru/server/ВАШ_СЕРВЕР#vote" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/vote-120x60.png" width="120" height="60" alt="L2Signal — анонсы серверов Lineage 2"></a>

<a href="https://l2signal.ru/server/ВАШ_СЕРВЕР#vote" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/vote-88x31.png" width="88" height="31" alt="L2Signal — анонсы серверов Lineage 2"></a>

Подойдёт любой размер — скопируйте код под нужным баннером.

728 × 90

HTMLКопировать

<a href="https://l2signal.ru" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/l2signal-728x90.png" width="728" height="90" alt="L2Signal — анонсы серверов Lineage 2"></a>

468 × 60

HTMLКопировать

<a href="https://l2signal.ru" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/l2signal-468x60.png" width="468" height="60" alt="L2Signal — анонсы серверов Lineage 2"></a>

240 × 400

HTMLКопировать

<a href="https://l2signal.ru" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/l2signal-240x400.png" width="240" height="400" alt="L2Signal — анонсы серверов Lineage 2"></a>

88 × 31

HTMLКопировать

<a href="https://l2signal.ru" target="_blank" title="L2Signal — анонсы серверов Lineage 2"><img src="https://l2signal.ru/banners/l2signal-88x31.png" width="88" height="31" alt="L2Signal — анонсы серверов Lineage 2"></a>