async def ships_statistics_in_ranked_battles( self, region: Region, account_id: int, *, access_token: str = None, fields: str = None, language: str = None, season_id: l_int = None, ship_id: l_int = None) -> dict: """ Method returns players' ships statistics in Ranked Battles seasons. Accounts with hidden game profiles are excluded from response. Hidden profiles are listed in the field meta.hidden. :param region: The region that the method will use. :param account_id: Player account ID :param access_token: Access token for the private data of a user's account; can be received via the authorization method; valid within a stated time period :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 :param season_id: Season ID. Max limit is 100. :type season_id: int or List[int] :param ship_id: Player's ship ID. Max limit is 100. :type ship_id: int or List[int] """ season_id = lst_of_int(season_id, 'season_id') ship_id = lst_of_int(ship_id, 'ship_id') param = { 'account_id': account_id, 'access_token': access_token, 'fields': fields, 'language': language, 'season_id': season_id, 'ship_id': ship_id } return await self.__get_res(region, 'seasons', 'shipstats', param)
async def player_statistics_by_date(self, region: Region, account_id: l_int, *, access_token: str = None, dates: str = None, extra: str = None, fields: str = None, language: str = None) -> dict: """ Method returns statistics slices by dates in specified time span. :param region: The region that the method will use. :param account_id: Player account ID. Max limit is 100. Min value is 1. :type account_id: int or List[int] :param access_token: Access token for the private data of a user's account; can be received via the authorization method; valid within a stated time period :param dates: List of dates to return statistics slices for, separated with commas. Format: YYYYMMDD. Max. dates range - 28 days from the current date. Statistics slice for yesterday will be returned by default. Max limit is 10. :param extra: Extra fields that will be added to the response, separated with commas. Valid values: "pve" :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 """ account_id = lst_of_int(account_id, 'account_id') param = { 'account_id': account_id, 'access_token': access_token, 'dates': dates, 'extra': extra, 'fields': fields, 'language': language } return await self.__get_res(region, 'account', 'statsbydate', param)
async def modules(self, region: Region, *, fields: str = None, language: str = None, module_id: l_int = None, type_: str = None) -> dict: """ Method returns the list of available modules that can be installed on ships, such as hulls, engines, etc. At least one input filter parameter (module_id or type_) is required to be indicated. :param region: The region that the method will use. :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) :param module_id: Module ID. Max limit is 100. :type module_id: int or List[int] :param type_: Module type. Valid values: "Artillery" — Main battery "Torpedoes" — Torpedo tubes "Suo" — Gun Fire Control System "FlightControl" — Flight Control "Hull" — Hull "Engine" — Engine "Fighter" — Fighters "TorpedoBomber" — Torpedo Bombers "DiveBomber" — Dive bombers """ module_id = lst_of_int(module_id, 'module_id') param = { 'fields': fields, 'language': language, 'module_id': module_id, 'type': type_ } return await self.__get_res(region, 'encyclopedia', 'modules', param)
async def warships(self, region: Region, *, fields: str = None, language: str = None, nation: str = None, ship_id: l_int = None, type_: str = None) -> dict: """ Method returns the list of ships available. :param region: The region that the method will use. :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) :param nation: Nations, separated with commas. Max limit is 100. :param ship_id: Ship ID. Max limit is 100. :type ship_id: int or List[int] :param type_: Ship type, separated with commas. Max limit is 100. Valid values: "AirCarrier" — Aircraft carrier "Battleship" — Battleship "Destroyer" — Destroyer "Cruiser" — Cruiser """ ship_id = lst_of_int(ship_id, 'ship_id') param = { 'fields': fields, 'language': language, 'nation': nation, 'ship_id': ship_id, 'type': type_ } return await self.__get_res(region, 'encyclopedia', 'ships', param)
async def exterior_items(self, region: Region, *, exterior_id: l_int = None, fields: str = None, language: str = None, type_: str = None) -> dict: """ Method returns information about signals & camouflages. :param region: The region that the method will use. :param exterior_id: Exterior item ID. Max limit is 100. :type exterior_id: int or List[int] :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) :param type_: Exterior item type. """ exterior_id = lst_of_int(exterior_id, 'exterior_id') param = { 'exterior_id': exterior_id, 'fields': fields, 'language': language, 'type': type_ } return await self.__get_res(region, 'encyclopedia', 'exterior', param)
async def player_clan_data(self, region: Region, account_id: l_int, *, extra: str = None, fields: str = None, language: str = None) -> dict: """ Method returns player clan data. Player clan data exist only for accounts, that were participating in clan activities: sent join requests, were clan members etc. :param region: The region that the method will use. :param account_id: Account ID. Max limit is 100. Min value is 1. :param extra: Extra fields that will be added to the response. Valid values: "clan" :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 """ account_id = lst_of_int(account_id, 'account_id') param = { 'account_id': account_id, 'extra': extra, 'fields': fields, 'language': language } return await self.__get_res(region, 'clans', 'accountinfo', param)
async def upgrades(self, region: Region, *, fields: str = None, language: str = None, upgrade_id: l_int = None) -> dict: """ Method returns the list of available ship upgrades. :param region: The region that the method will use. :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) :param upgrade_id: Upgrade ID. Max limit is 100. :type upgrade_id: int or List[int] :rtype: dict """ upgrade_id = lst_of_int(upgrade_id, 'upgrade_id') param = { 'fields': fields, 'language': language, 'upgrade_id': upgrade_id } return await self.__get_res(region, 'encyclopedia', 'upgrades', param)
async def clan_details(self, region: Region, clan_id: l_int, *, extra: str = None, fields: str = None, language: str = None) -> dict: """ Method returns detailed clan information. :param region: The region that the method will use. :param clan_id: Clan ID. Max limit is 100. Min value is 1. :param extra: Extra fields that will be added to the response. Valid values: "members" :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 """ clan_id = lst_of_int(clan_id, 'clan_id') param = { 'clan_id': clan_id, 'extra': extra, 'fields': fields, 'language': language } return await self.__get_res(region, 'clans', 'info', param)
def ranked_battles_seasons(self, region: Region, *, fields: str = None, language: str = None, season_id: l_int = None) -> dict: """ Method returns information about Ranked Battles seasons. :param region: The region that the method will use. :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) :param season_id: Season ID. Max limit is 100. :type season_id: int or List[int] """ season_id = lst_of_int(season_id, 'season_id') param = { 'fields': fields, 'language': language, 'season_id': season_id } return self.__get_res(region, 'seasons', 'info', param)
def commanders(self, region: Region, *, commander_id: l_int = None, fields: str = None, language: str = None) -> dict: """ Method returns the information about Commanders. :param region: The region that the method will use. :param commander_id: Commander ID. Max limit is 100. :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 "tr" — Türkçe "zh-cn" — 中文 "pt-br" — Português do Brasil "es-mx" — Español (México) """ commander_id = lst_of_int(commander_id, 'commander_id') param = { 'commander_id': commander_id, 'fields': fields, 'language': language } return self.__get_res(region, 'encyclopedia', 'crews', param)
async def player_personal_data(self, region: Region, account_id: l_int, *, access_token: str = None, extra: str = None, fields: str = None, language: str = None) -> dict: """ Method returns player details. Players may hide their game profiles, use field hidden_profile for determination. :param region: The region that the method will use. :param account_id: Player account ID. Max limit is 100. Min value is 1. :type account_id: int or List[int] :param access_token: Access token for the private data of a user's account; can be received via the authorization method; valid within a stated time period :param extra: Extra fields that will be added to the response, separated with commas. Valid values: "private.grouped_contacts" "private.port" "statistics.club" "statistics.pve" "statistics.pve_div2" "statistics.pve_div3" "statistics.pve_solo" "statistics.pvp_div2" "statistics.pvp_div3" "statistics.pvp_solo" "statistics.rank_div2" "statistics.rank_div3" "statistics.rank_solo" :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 """ account_id = lst_of_int(account_id, 'account_id') param = { 'account_id': account_id, 'access_token': access_token, 'extra': extra, 'fields': fields, 'language': language } return await self.__get_res(region, 'account', 'info', param)
async def statistics_of_players_ships(self, region: Region, account_id: int, *, access_token: str = None, extra: str = None, fields: str = None, in_garage: bool = None, language: str = None, ship_id: l_int = None) -> dict: """ Method returns general statistics for each ship of a player. Accounts with hidden game profiles are excluded from response. Hidden profiles are listed in the field meta.hidden. :param region: The region that the method will use. :param account_id: Player account ID :param access_token: Access token for the private data of a user's account; can be received via the authorization method; valid within a stated time period :param extra: Extra fields that will be added to the response, separated with commas. Valid values: "club" "pve" "pve_div2" "pve_div3" "pve_solo" "pvp_div2" "pvp_div3" "pvp_solo" "rank_div2" "rank_div3" "rank_solo" :param fields: Response field. The fields are separated with commas. Embedded fields are separated with dots. To exclude a field, use “-” in front of its name. In case the parameter is not defined, the method returns all fields. Max limit is 100. :param in_garage: Filter by ship availability in the Port. If the parameter is not specified, all ships are returned. Parameter processing requires a valid access_token for the specified account_id. True — Return ships available in the Port. False — Return ships that are no longer in the Port. :param language: Localization language. Default depends on region. Valid values: "cs" — Čeština "de" — Deutsch "en" — English (Default for NA and EU) "es" — Español "fr" — Français "ja" — 日本語 "pl" — Polski "ru" — Русский (Default for RU) "th" — ไทย (Default for AS) "zh-tw" — 繁體中文 :param ship_id: Player's ship ID. Max limit is 100. :type ship_id: int or List[int] """ ship_id = lst_of_int(ship_id, 'ship_id') if in_garage is not None: in_garage = '1' if in_garage else '0' param = { 'account_id': account_id, 'access_token': access_token, 'extra': extra, 'fields': fields, 'in_garage': in_garage, 'language': language, 'ship_id': ship_id } return await self.__get_res(region, 'ships', 'stats', param)