API: различия между версиями

Материал из Энциклобогии
Перейти к навигации Перейти к поиску
мНет описания правки
м (поправлена опечатка)
Строка 7: Строка 7:
  www.godville.net/gods/api/<username>.json
  www.godville.net/gods/api/<username>.json


Смысл большинства полей очевиднен из их названия. Самое сложное:
Смысл большинства полей очевиден из их названия. Самое сложное:


* '''expired''' - показатель неактуальности данных. Для того, чтобы данные подавались в реальном времени, требуется периодическое (раз в час) посещение страницы героя или любая активность пользователя на ней. Если ''expired = true'', то герой не посещался слишком давно и остальные данные уже не актуальны ''(знаем, что неудобно, но пока только так)''.  
* '''expired''' - показатель неактуальности данных. Для того, чтобы данные подавались в реальном времени, требуется периодическое (раз в час) посещение страницы героя или любая активность пользователя на ней. Если ''expired = true'', то герой не посещался слишком давно и остальные данные уже не актуальны ''(знаем, что неудобно, но пока только так)''.  

Версия от 03:50, 13 июня 2009

Сервер Годвилля предоставляет программный доступ к большинству данных героя, который можно использовать для написания сторонних программ.

АПИ доступен в двух форматах (XML и JSON):

www.godville.net/gods/api/<username>.xml

или

www.godville.net/gods/api/<username>.json

Смысл большинства полей очевиден из их названия. Самое сложное:

  • expired - показатель неактуальности данных. Для того, чтобы данные подавались в реальном времени, требуется периодическое (раз в час) посещение страницы героя или любая активность пользователя на ней. Если expired = true, то герой не посещался слишком давно и остальные данные уже не актуальны (знаем, что неудобно, но пока только так).
  • diary_last - последняя запись из дневника героя.
  • arena_fight - показатель нахождения на арене или в полевом пвп (можно использовать для индикации необходимости присмотра пользователем).

Данные обновляются раз в минуту, поэтому дергать сервер чаще смысла нет.