Внешние сообщения: различия между версиями
Bear (обсуждение | вклад) |
Bear (обсуждение | вклад) Нет описания правки |
||
Строка 5: | Строка 5: | ||
Сообщения отправляются через запрос GET: | Сообщения отправляются через запрос GET: | ||
<nowiki>http://ru'''X'''.voyna-plemyon.ru/send_mail.php?from_id=FROM_ID&api_key=API_KEY&to=TO&subject=SUBJECT&message=MESSAGE</nowiki> | <nowiki>http://ru'''X'''.voyna-plemyon.ru/send_mail.php?from_id=FROM_ID&api_key=API_KEY&to=TO&subject=SUBJECT&message=MESSAGE</nowiki><br> | ||
где X - номер мира<br> | где X - номер мира<br> | ||
'''''Значения параметров:''''' | '''''Значения параметров:''''' |
Версия от 13:32, 24 ноября 2010
Отправка писем через внешний интерфейс
Иногда желательно, чтобы внешние программы могли посылать сообщения игрокам, чтобы информировать их о важных событиях или подтверждать их личность. Так как правила запрещают использования роботов, мы разработали для этой цели программный интерфейс.
Сообщения отправляются через запрос 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);