Join the new world

Газета 3,14ОНЕР продолжает свою серию статей для молодых товарищей.


Never send a human to do a machine's job.
Agent Smith



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

Вы хотите следить за динамикой цен?
Вы хотите отслеживать колебания курсов валют?
Вы хотите провести перепись населения еРоссии?
Вы хотите наладить мониторинг за компаниями конкурентов?
Вы хотите собирать статистику о происходящих битвах?
Вы хотите проводить народные голосования, основанные на авторизации по логину и паролю от eRepublik?

Хотите этого не только вы, и потому разработчики eRepublik открыли проект eAPI.
Следует сразу оговориться, что проект молодой, зелёный, и ситуация с ним постоянно меняется, причем не всегда в лучшую сторону. Если вы хотите быть всегда в курсе всех новостей об этом проекте, следите за гуглогруппой.


Основные возможности, предоставленные нам разработчиками:

1. Просмотр списка всех стран, регионов и их жителей
Список всех стран доступен по адресу: http://api.erepublik.com/v1/feeds/countries
Далее, для каждой страны из списка можно получить список всех её текущих регионов: http://api.erepublik.com/v1/feeds/countries/{COUNTRY_ID} ( пример )
Далее, для каждого региона из списка можно получить список всех его жителей: http://api.erepublik.com/v1/feeds/regions/{REGION_ID} ( пример )
Далее, для каждого жителя из списка можно получить детальную информацию о нём: http://api.erepublik.com/v1/feeds/citizens/{CITIZEN_ID} ( пример )
Альтернативный адрес получения информации о жителе: http://api.erepublik.com/v1/feeds/citizens/{CITIZEN_NAME}?by_username=true ( пример )

Приведенные ссылки дают информацию в формате XML.
Приписав к ним ".json", вы можете получить ту же самую информацию в формате JSON. Это может быть удобнее, чем XML, например, если вы используете javascript.

Заметим, что информацию об организациях таким образом получить нельзя.
Также не удастся выяснить, какой из регионов, принадлежащих стране, является её оригинальным регионом, а какой оккупирован. Для этих целей можно использовать запрос вида http://www.erepublik.com/region-list/{COUNTRY_ID} (данные в формате JSON).
Не увидите вы и полного списка существующих компаний. Просмотрев всех граждан, вы сможете лишь составить список компаний, в которых работает хотя бы один работник.

2. Просмотр детальной информации о компаниях и ситуации на рынках
Информация о конкретной компании доступна по адресу: http://api.erepublik.com/v1/feeds/companies/{COMPANY_ID} ( пример )
Первые 10 предложений на рынке доступны по адресу: http://api.erepublik.com/v1/feeds/market/{INDUSTRY_NAME}/{QUALITY}/{COUNTRY_NAME} ( пример )
Первые 10 предложений на валютном рынке доступны по адресу: http://api.erepublik.com/v1/feeds/exchange/{SELL_CURRENCY}/{BUY_CURRENCY} ( пример )

Все три источника также дают данные в формате XML, а с припиской ".json" – в формате JSON.

Следует учитывать, что данные о ситуации на рынках не являются актуальными. Период их обновления автору точно неизвестен, если кто-нибудь обладает такой информацией, просим сообщить в редакцию для добавления её в статью.

3. Просмотр информации о войнах и битвах
Информация об активных и завершенных боях в конкретной войне доступна по адресу: http://api.erepublik.com/v1/feeds/war/{WAR_ID} ( пример )
Лог боя (список ударов солдат с указанием времени и урона) доступен по адресу: http://api.erepublik.com/v1/feeds/battle_logs/{BATTLE_ID}/{PAGE_NUMBER} ( пример )

На каждой странице лога записано 1000 ударов.
На момент публикации:
- полное количество страниц в логе узнать нельзя (поле ma😜ages содержит ложную информацию)
- сервис работает таким образом, что после окончания битвы из лога удаляется последняя страница
- данные о войнах и битвах доступны только в формате XML
- получить полный список открытых войн нельзя

4. Просмотр текущей геополитической ситуации в еМире
Информация о текущем статусе регионов, заключенных МПП и активных битвах доступна по адресу: http://api.erepublik.com/map/data/{DATE} ( пример )
Эти данные тоже можно получить только в формате XML.

5. Авторизация пользователя по его логину и паролю в eRepublik, а также реализация финансовых транзакций (донатов)
Эта тема довольно большая, к тому же требующая знакомства с протоколом OAuth. Возможно, впоследствии редакция посвятит этой теме отдельную статью.
Официальная информация об этих услугах доступна здесь.


Примечание
На данный момент разработчиками заявлено ограничение на количество HTTP-запросов с одного IP-адреса: не более 7000 запросов в 30 минут.
При превышении данного лимита, все запросы с вашего адреса к api.erepublik.com будут уходить в timeout. Эффект длится, по заявлениям разработчиков, 12 часов, после чего вы снова можете посылать запросы серверу.



[propaganda]
Техника решает всё!
еСоветская еВласть – это постиндустриализация плюс информатизация всей страны!
Закон постиндустриализации – конец деревне, неинформированной, непосчитанной, невежественной!
[/propaganda]