Внешние сообщения

Материал из Tribalwars Wiki RU
Перейти к навигации

Отправка писем через внешний интерфейс

Иногда желательно, чтобы внешние программы могли посылать сообщения игрокам, чтобы информировать их о важных событиях или подтверждать их личность. Так как правила запрещают использования роботов, мы разработали для этой цели программный интерфейс.

Сообщения отправляются через запрос GET:

http://ru'''X'''.voyna-plemyon.ru/send_mail.php?from_id=FROM_ID&api_key=API_KEY&to=TO&subject=SUBJECT&message=MESSAGE
где X - номер мира
Значения параметров:

  • FROM_ID: идентификатор вашего аккаунта (вы его можете посмотреть, например, в рейтинге)
  • API-код: ваш API-код (чтоб найти его, зайдите в Настройки->Настройки)
  • TO: имя (не ID) получателя
  • SUBJECT: тема сообщения
  • MESSAGE: собственно, сообщение

Эта опция доступна только владельцам премиум-аккаунта. В случае её использования для спама, надоедания другим игрокам и других злоупотреблений, аккаунт может быть заблокирован.

Пример на PHP:
// Параметры должны быть в URL-кодировке
$to = urlencode('exception');
$subject = urlencode('тест & тест');
$message = urlencode('Проба пера');

$base_url = "http://ru10.voyna-plemyon.ru/send_mail.php?from_id=FROM_ID&api_key=API_KEY";

// обратиться к URL
$handle = fopen($base_url . "&to=$to&subject=$subject&message=$message", 'r');
echo fgets($handle); // Показать ответ
fclose($handle);