/pyroyale

UNMAINTAINED - ClashRoyale API wrapper for Python

Primary LanguagePythonGNU Lesser General Public License v3.0LGPL-3.0

NOTE - this project is no longer maintained. If you are a pyroyale user, and wish to take over maintaintainership of this project, please contact me.

pyroyale

Unofficial python client for the official Clash Royale API

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import pyroyale 

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import pyroyale

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import pyroyale
from pyroyale.rest import ApiException
from pprint import pprint

configuration = pyroyale.Configuration()
# Configure API key authorization: JWT
configuration.api_key['authorization'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['authorization'] = 'Bearer'

# Defining host is optional and default to https://api.clashroyale.com/v1
configuration.host = "https://api.clashroyale.com/v1"
# Create an instance of the API class
api_instance = pyroyale.CardsApi(pyroyale.ApiClient(configuration))

try:
    # Get list of available cards
    api_response = api_instance.get_cards()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling CardsApi->get_cards: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.clashroyale.com/v1

Class Method HTTP request Description
CardsApi get_cards GET /cards Get list of available cards
ClansApi get_clan GET /clans/{clanTag} Get clan information
ClansApi get_clan_members GET /clans/{clanTag}/members List clan members
ClansApi get_clan_war_log GET /clans/{clanTag}/warlog Retrieve clan's clan war log
ClansApi get_current_war GET /clans/{clanTag}/currentwar Information about clan's current clan war
ClansApi search_clans GET /clans Search clans
LocationsApi get_clan_ranking GET /locations/{locationId}/rankings/clans Get clan rankings for a specific location
LocationsApi get_clan_wars_ranking GET /locations/{locationId}/rankings/clanwars Get clan war rankings for a specific location
LocationsApi get_location GET /locations/{locationId} Get location information
LocationsApi get_locations GET /locations List locations
LocationsApi get_player_ranking GET /locations/{locationId}/rankings/players Get player rankings for a specific location
PlayersApi get_player GET /players/{playerTag} Get player information
PlayersApi get_player_battles GET /players/{playerTag}/battlelog Get log of recent battles for a player
PlayersApi get_player_upcoming_chests GET /players/{playerTag}/upcomingchests Get information about player's upcoming chests
TournamentsApi get_global_tournaments GET /globaltournaments List global tournaments
TournamentsApi get_tournament GET /tournaments/{tournamentTag} Get tournament information
TournamentsApi search_tournaments GET /tournaments Search tournaments

Documentation For Models

Documentation For Authorization

JWT

  • Type: API key
  • API key parameter name: authorization
  • Location: HTTP header

Author

Development links

This project uses SonarQube for static analysis. The results of analysis are at SonarCloud. The code quality and test coverage are a work in progress.