Документация

Better desc later

Основное

Адрес обращения

URL: https://gg-community.ru/api/CustomStorages.interaction

Ключ авторизации

Любой метод требует авторизации с ключом. Производится в заголовке запроса.

'header' -> 'ключ API'

Есть (временный) альтернативный способ через простое указывание GET/POST параметра key.

Методы

Запросы декларируются через GET/POST параметр act.

Аргументы/параметры

Помимо act, в некоторых методах требуется указывать параметр data.

Параметр data должен представлять строку JSON-массива.

Ключи этого массива должны перечислятся в строгом порядке, в каком они перечислены в этой документации.

Доступные методы

get_players

Отдает базовую информацию об игроках с указанными SteamID. Добавляет в базу отсутствующих.

Принимает

• record_disabled: bool
  • Если true, обнаруженные новые игроки не добавляются в базу.
• players: [array]
  • Массив с массивами ID игроков. Данный порядок сохраняется при выводе.
  • steam_id: int

Возвращает

• players: [array]
  • steam_id: int
  • new_player?: bool
    • Указывается и возвращает true только тогда, когда игрока нет в базе данных.
  • currency: array
    • vayu: int
    • prana: int

get_player_avatars

Принимает

• steam_id: int

Возвращает

• count: int
  • Количество имеющихся аватаров.
• collection: [array | null]
  • hero_name: string
    • Кодовое название NPC-героя (пример: npc_dota_hero_night_stalker).

change_currency

Изменяет указанную валюту на указанное значение (может быть отрицательным) у указанного игрока.

Принимает

• steam_id: int
• target_currency: string (vayu | prana)
• change: int

Возвращает

• new_value: int
  • Новое значение указанной валюты после изменения.