trevorphillipscoding / python-blizzardapi

python-blizzardapi is a client library for Blizzard's APIs.

python-blizzardapi

python-blizzardapi is a client library for Blizzard's APIs.

Current supported features include:

• Battle.net User
• Wow Profile
• Wow Game Data
• Wow Classic Game Data
• Diablo 3 Community
• Diablo 3 Game Data
• Hearthstone Game Data

To gain access to Blizzard's API please register here to obtain a client id and client secret.

For more information on Blizzard's API visit:

Official Documentation
Official API Forum

Requirements

Python (3.6, 3.7, 3.8, 3.9)

Installing

pip install python-blizzardapi

Example

main.py

from blizzardapi import BlizzardApi

api_client = BlizzardApi("client_id", "client_secret")

# Unprotected API endpoint
categories_index = api_client.wow.game_data.get_achievement_categories_index("us", "en_US")

# Protected API endpoint
summary = api_client.wow.profile.get_account_profile_summary("us", "en_US", "access_token")

# Wow Classic endpoint
connected_realms_index = api_client.wow.game_data.get_connected_realms_index("us", "en_US", is_classic=True)

Access token vs Client ID/Client Secret

You can pass in a client_id and client_secret and use almost any endpoint except for a few that require an access_token obtained via OAuth authorization code flow. You can find more information at https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow.

Here is the list of endpoints, specified by Blizzard, that require an OAuth token.

GET /oauth/userinfo
GET /profile/user/wow
GET /profile/user/wow/protected-character/{realm-id}-{character-id}
GET /profile/user/wow/collections
GET /profile/user/wow/collections/pets
GET /profile/user/wow/collections/mounts

python-blizzardapi's Issues

Can't access protected endpoints (crash)

I tried the three python-blizzardapi examples but one of them crashes.
JSONDecodeError: Expecting value: line 1 column 1 (char 0)
The three examples from the README.md are seen in use here
(or here if GitHub is crapping out again.)

perhaps I'm doing the Oath flow wrong or maybe this happens with an inactive WOW account or maybe I'm supposed to be getting the access-token from python-blizzardapi somehow.