Warcraft Log API using python and oAUTH

Get your clientId and clientSecret from Warcraft Logs website

Warcraft Logs uses OAuth 2.0 for API authentication.

OAuth allows clients to request and then use an access token to authenticate API requests.
When using a library, developers typically need four items to get started: 
  > client_id, 
  > client_secret, 
  > authorize_uri , and 
  > token_uri.

The first step in using OAuth is getting a client_id and client_secret by creating a new client.

  > Log in to Warcraft Logs.
  > Go to the client management page and click Create Client.
  > Enter a client name. The client name is used to identify the client in the list view.
  > Enter any redirect URIs needed. 
  > Click Create. 

The Authorization URI is: https://www.warcraftlogs.com/oauth/authorize

The Token URI is: https://www.warcraftlogs.com/oauth/token

Client Credentials Flow

To request access tokens, an application must make a POST request with the following multipart form data to the token URI: grant_type=client_credentials The application must pass basic HTTP auth credentials using the client_id as the user and the client_secret as the password.

curl -u {client_id}:{client_secret} -d grant_type=client_credentials https://www.warcraftlogs.com/oauth/token

After an application retrieves an access token, it provides that token when making requests to API resources. This is done via an authorization header:

curl --header "Authorization: Bearer <access_token>" <GRAPHQL API URL>

How to use wowlog-data

Export your clientId and clientSecret to Shell environment using the following two commands

echo "export userId='YOUR USER ID'" >> ~/.zshrc

echo "export userSECRET='YOUR USER SECRET'" >> ~/.zshrc

To verify that the variables are saved

echo $userId echo secretId

Run the app

python app.py

The app will fetch the access token, store it in a hidden json file and then fetch it in order to send a query to warcraft logs API. You will need to install python and add it to your environmental path

Example retrived data

{'id': 19, 'name': 'Anetheron', 'startTime': 18002072, 'endTime': 18153347}, 
{'id': 28, 'name': "Kaz'rogal", 'startTime': 19310047, 'endTime': 19456852}, 
{'id': 38, 'name': 'Azgalor', 'startTime': 20412751, 'endTime': 20642786}, 
{'id': 48, 'name': 'Azgalor', 'startTime': 21755912, 'endTime': 21950501}, 
{'id': 49, 'name': 'Archimonde', 'startTime': 22511684, 'endTime': 22597698}, 
{'id': 50, 'name': 'Archimonde', 'startTime': 23006011, 'endTime': 23112268}, 
{'id': 51, 'name': 'Archimonde', 'startTime': 23565082, 'endTime': 23766114}, 
{'id': 52, 'name': 'Archimonde', 'startTime': 24402390, 'endTime': 24667629}]

Heroku Deployment

Raiddon WarcraftLogs API

Viewing Detailed Documentation

GraphQL uses schemas that document everything, so if you use a client like Insomnia, you can fetch the schemas and start browsing the API documentation in the client itself.

You can also view the schema in your browser by clicking here.

Legal

This project is not authored, affiliated or endorsed in any way by WarcraftLogs.
If you have any support questions, please reach out to support team at support@warcraftlogs.com.