Энциклобогия

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

Статья Обсуждение

API (посмотреть исходный код)

Версия от 09:40, 20 июня 2025

1451 байт добавлено ,  20 июня 2025
м
Добавлен упущенный параметр "boss_power".
Нет описания правки
Метка: visualeditor
м (Добавлен упущенный параметр "boss_power".)
 
(не показано 12 промежуточных версий 6 участников)
Строка 11: Строка 11:
  godville.net/gods/api/<godname>/<token>
  godville.net/gods/api/<godname>/<token>


Для доступа ко второму API хозяину героя нужно получить ключ (token) в [https://godville.net/user/profile профиле] игры. Изредка ключ может сбрасываться (в этом случае приватный API превратится в открытый) - разработчикам стоит предвидеть такую ситуацию и предлагать пользователю сходить в профиль за новым.
Для доступа ко второму API хозяину героя нужно получить ключ (token) в [https://godville.net/user/profile профиле] игры. Изредка ключ может сбрасываться (в этом случае приватный API превратится в открытый) — разработчикам стоит предвидеть такую ситуацию и предлагать пользователю сходить в профиль за новым.


Общие моменты:  
Общие моменты:  
* API возвращает данные только в формате JSON.  
* API возвращает данные только в формате JSON.  
* Данные обновляются '''раз в минуту''', поэтому дергать сервер чаще смысла нет. При слишком частых запросах данные героя перестают возвращаться, выводя соответствующее уведомление.
* Данные обновляются '''раз в минуту''', поэтому дергать сервер чаще смысла нет. При слишком частых запросах данные героя перестают возвращаться, выводя соответствующее уведомление.
Строка 21: Строка 20:
{| class="wikitable collapsible sortable"  
{| class="wikitable collapsible sortable"  
|-
|-
!colspan="4" align="left" |Список ключей JSON<ref>Уточнения приветствуются.</ref>
! colspan="4" align="left" |Список ключей JSON<ref>Уточнения приветствуются.</ref>
|-
! Ключ || Тип || Описание || Только с ключом?
|-
| activatables || Объект || Массив с перечнем активируемых трофеев в инвентаре || '''Да'''
|-
| ark_f || Число || Число собранных тварей женского пола (только у ковчеговладельцев, max = "1000") || Нет
|-
| ark_m || Число || Число собранных тварей мужского пола (только у ковчеговладельцев, max = "1000") || Нет
|-
| arena_won || Число || Счетчик побед на арене || Нет
|-
| arena_lost || Число || Счетчик поражений на арене || Нет
|-
| arena_fight || Bool || Находится ли герой на арене/в бою с боссом/в заплыве/ или в подземелье (см. fight_type) || '''Да'''
|-
| ark_completed_at || Строка || Дата постройки ковчега (есть у всех, null — если ковчег не достроен) || Нет
|-
| ark_name || Строка || Название ковчега (есть у тех, кто назвал ковчег) || Нет
|-
|-
!Ключ || Тип || Описание || Только с ключом?
| alignment || Строка || Характер героя || Нет
|-
|-
|activatables || Объект || Массив с перечнем активируемых трофеев в инвентаре || '''Да'''
| aura || Строка || Аура героя (без времени; отсутствует без ауры) || '''Да'''
|-
|-
|ark_f || Число || Число собранных тварей женского пола (только у ковчеговладельцев) || Нет
| pairs_at || Строка || Дата окончания сбора тварей || Нет
|-
|-
|ark_m || Число || Число собранных тварей мужского пола (только у ковчеговладельцев) || Нет
| book_at || Строка || Дата окончания написания книги || Нет
|-
|-
|arena_won || Число || Счетчик побед на арене || Нет
| souls_at || Строка || Дата окончания сбора душ || Нет
|-
|-
|arena_lost || Число || Счетчик поражений на арене || Нет
| boss_name || Строка || Имя собранного в лаборатории босса || Нет
|-
|-
|arena_fight || Bool || Находится ли герой на арене/в бою с боссом/в заплыве/ или в подземелье (см. fight_type) || '''Да'''
| boss_power|| Число || Мощь собранного в лаборатории босса || Нет
|-
|-
|ark_completed_at || Строка || Дата постройки ковчега (есть у всех, null - если ковчег не достроен) || Нет
| bricks_cnt || Число || Количество кирпичей (в штуках, не в процентах; есть всегда, max = "1000") || Нет
|-
|-
|alignment || Строка || Характер героя || Нет
| clan || Строка || Название гильдии героя (пустая строка, если её нет) || Нет
|-
|-
|aura || Строка || Аура героя (без времени; отсутствует без ауры) || '''Да'''
| clan_position || Строка || Звание в гильдии (если гильдии нет, то пустая строка) || Нет
|-
|-
|book_at || Строка || Дата окончания написания книги || Нет
| diary_last || Строка || Последняя запись в дневнике || '''Да'''
|-
|-
|boss_name || Строка || Имя собранного в лаборатории босса || Нет
| eye_last || Строка || Последняя запись в третьем глазе || '''Да'''
|-
|-
|bricks_cnt || Число || Количество кирпичей (в штуках, не в процентах; есть всегда) || Нет
| distance || Число || Расстояние до столицы (при нахождении в Годвилле = 0) || '''Да'''
|-
|-
|clan || Строка || Название гильдии героя (пустая строка, если её нет) || Нет
| exp_progress || Число || Прогресс опыта  || '''Да'''
|-
|-
|clan_position || Строка || Звание в гильдии (если гильдии нет, то пустая строка) || Нет
| expired || Bool || показатель неактуальности данных (ключ появляется, когда данные неактуальны)<ref>Чтобы данные стали актуальными, требуется периодическое (раз в час) посещение страницы героя в браузере или одним из [[Клиент_для_Android|полноценных клиентов]]. Если ''expired = true'', то герой не посещался слишком давно и остальные данные уже не актуальны.</ref> || '''Да'''
|-
|-
|diary_last || Строка || Последняя запись в дневнике || '''Да'''
| fight_type || Строка || Тип боя (см. таблицу ниже) || '''Да'''
|-
|-
|distance || Число || Расстояние до столицы (при нахождении в любом городе 0) || '''Да'''
| godpower || Число || Количество праны (для пенсионеров 0-200) <ref>Во время битвы с боссом (возможно и в остальных битвах при arena_fight = true) равняется нулю.</ref> || '''Да'''
|-
|-
|exp_progress || Число || Прогресс опыта || '''Да'''
| gold_approx || Строка || Приблизительное количество золота || '''Да'''
|-
|-
|expired || Bool || показатель неактуальности данных (ключ появляется, когда данные неактуальны)<ref>Чтобы данные стали актуальными, требуется периодическое (раз в час) посещение страницы героя в браузере или одним из [[Клиент_для_Android|полноценных клиентов]]. Если ''expired = true'', то герой не посещался слишком давно и остальные данные уже не актуальны.</ref> || '''Да'''
| gender || Строка || Пол героя || Нет
|-
|-
|fight_type || Строка || Тип боя (см. таблицу ниже) ||'''Да'''
| godname || Строка || Имя бога  || Нет
|-
|-
|godpower || Число || Количество праны (для пенсионеров 0-200)  || '''Да'''
| health || Число || Здоровье героя<ref>Здоровье именно героя. Не босса и не ковчега. То есть в подземелье оно показывает актуальные данные, а вот в море и на полигоне - просто состояние героя перед началом приключения.</ref> || '''Да'''
|-
|-
|gold_approx || Строка || Приблизительное количество золота  || '''Да'''
| <strike>inventory</strike> || Объект || Удален, вместо него теперь 'activatables' || '''Да'''
|-
|-
|gender || Строка || Пол героя  || Нет
| inventory_max_num || Число || Максимальный размер инвентаря (max = "50") || Нет
|-
|-
|godname || Строка || Имя бога  || Нет
| inventory_num || Число || Количество вещей в инвентаре || '''Да'''
|-
|-
|health || Число || Здоровье героя<ref>Здоровье именно героя. Не босса и не ковчега. То есть в подземелье оно показывает актуальные данные, а вот в море и на полигоне - просто состояние героя перед началом приключения.</ref> || '''Да'''
| level || Число || Уровень героя || Нет
|-
|-
|<strike>inventory</strike> || Объект || Удален, вместо него теперь 'activatables' || '''Да'''
| max_health || Число || Максимальный запас здоровья || Нет
|-
|-
|inventory_max_num || Число || Максимальный размер инвентаря || Нет
| motto || Строка || Девиз (может быть пустой строкой) || Нет
|-
|-
|inventory_num || Число || Количество вещей в инвентаре || '''Да'''
| name || Строка || Имя героя || Нет
|-
|-
|level || Число || Уровень героя || Нет
| pet || Объект || Объект, содержащий описание питомца (подробности ниже) || Нет
|-
|-
|max_health || Число || Максимальный запас здоровья || Нет
| quest_progress || Число || Процент выполнения задания || '''Да'''
|-
|-
|motto || Строка || Девиз (может быть пустой строкой) || Нет
| quest || Строка || Текст текущего задания || '''Да'''
|-
|-
|name || Строка || Имя героя || Нет
| side_job_progress || Число || Процент выполнения подряда || '''Да'''
|-
|-
|pet || Объект || Объект, содержащий описание питомца (подробности ниже) || Нет
| side_job || Строка || Текст текущего подряда || '''Да'''
|-
|-
|quest_progress || Число || Процент выполнения задания || '''Да'''
| savings || Строка || Число сбережений (только у храмовладельцев, max = "30000 тысяч") || Нет
|-
|-
|quest || Строка || Текст текущего задания || '''Да'''
| savings_completed_at || Строка || Дата окончания сбора пенсии (только у пенсионеров) || Нет
|-
|-
|savings || Строка || Примерное число сбережений (только у храмовладельцев) || Нет
| shop_name || Строка || Название лавки (только у пенсионеров) || Нет
|-
|-
|savings_completed_at || Строка || Дата окончания сбора пенсии (только у пенсионеров) || Нет
| souls_percent || Строка || Количество собранных душ в процентах (только у книжников) || Нет
|-
|-
|shop_name || Строка || Название лавки (только у пенсионеров) || Нет
| relics_percent || Строка || Количество найденных реликвий в процентах || Нет
|-
|-
|t_level || Число || Уровень героя-торговца (только у лавочников) || Нет
| t_level || Число || Уровень героя-торговца (только у лавочников) || Нет
|-
|-
|temple_completed_at || Строка || Дата окончания храма (только у храмовладельцев) || Нет
| temple_completed_at || Строка || Дата окончания храма (только у храмовладельцев) || Нет
|-
|-
|town_name || Строка || Город, в котором герой (пустая строка, если в поле, и нет ключа, если в бою) || '''Да'''
| town_name || Строка || Город, в котором герой (пустая строка, если в поле, и нет ключа, если в бою) || '''Да'''
|-
|-
|wood_cnt || Число || Количество поленьев (пока нет храма, ключ отсутствует) || Нет
| wood_cnt || Число || Количество поленьев (пока нет храма, ключ отсутствует) || Нет
|-
|-
|words || Число || Число собранных слов для книги (без слогов) || Нет
| words || Число || Число собранных слов для книги (без слогов; ключ исчезает, если есть ключ book_at) || Нет
|}
|}


{| class="wikitable collapsible collapsed sortable"  
{| class="wikitable collapsible collapsed sortable"  
|-
|-
!colspan="3" align="left" |Объект pet (питомец)
! colspan="3" align="left" | Объект pet (питомец)
|-
|-
!Ключ || Тип || Описание  
! Ключ || Тип || Описание  
|-
|-
|pet_class || Строка || Вид питомца
| pet_class || Строка || Вид питомца
|-
|-
|pet_level || Число || Уровень питомца (пустая строка, если питомец лишился уровня)
| pet_level || Число || Уровень питомца (пустая строка, если питомец лишился уровня)
|-
|-
|pet_name || Строка || Имя питомца (например, Пуха «Беспечный»)<ref>У контуженного питомца имя содержит "❌".</ref>
| pet_name || Строка || Имя питомца (например, Пуха «Беспечный»)<ref>У контуженного питомца имя содержит "❌".</ref>
|-
|-
|wounded || Bool || Флаг контузии питомца (есть только у контуженого)
| wounded || Bool || Флаг контузии питомца (есть только у контуженого)
|}
{| class="wikitable collapsible collapsed sortable"
|-
|-
|}
! colspan="3" align="left" | Типы боев
{| class="wikitable mw-collapsible"
|+
! colspan="2" |Типы боев
|-
|-
!Ключ
! Ключ || Описание
!Описание
|-
|-
|arena
| arena || арена (ЗПГ в том числе)
|арена (ЗПГ в том числе)
|-
|-
|boss
| boss || босс (мини-квест)
|
|-
|-
|boss_m
| boss_m || босс (зацеп)
|
|-
|-
|challenge
| challenge || тренировка
|тренировка
|-
|-
|dungeon
| dungeon || подземелье
|подземелье
|-
|-
|multi_monster
| multi_monster || группа монстров
|группа монстров
|-
|-
|range
| range || полигон
|полигон
|-
|-
|sail
| sail || морской поход
|морской поход
|}
|}


=== Примечания ===
== Примечания ==
<references />
<references />
[[Категория:Техническое]]
[[Категория:Техническое]]
Skiller
23

правки

Источник — https://wiki.godville.net/Служебная:Сравнение_версий/162317...181060