1.0.1 • Published 2 years ago

hirez-wrapper v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

HiRez Wrapper

Version License

Wrapper for the HiRez API

Features

  • Zero dependencies
  • TypeScript support
  • Promise based
  • Downloading of data
  • Interfaces for all endpoints

Install

npm install hirez-wrapper -s

API

Before you can use this package you must apply for API access. Development Credentials Application Form The official documentation can also be found google docs

How to use

Basic usage

Import whichever game you would like to use. Set your API credentials before making any API calls. Await the method of your choice and get the data!

import { paladins, realmRoyale, smite } from 'hirez-wrapper'

// Replace with your credentials
// (dev_id, auth_key)
smite.credentials(1004, 23DF3C7E9BD14D84BF892AD206B6755C)

const data = await smite.getGods('english')
console.log(data) // => Array of all God data

Downloading data

All endpoints can be downloaded automatically with the download method

const data = await smite.getGods('english')
data.download()

Download has some optional options

const data = await smite.getGods('english')
data.download({
  filePath: '/path/to/location', // default: creates a download folder in project root
  fileName: 'god-data', // defaults: {unix time}-{game}-{endpoint}-{parameters}
  prettyPrint: false // default: true
})

Download will still return the original data

const data = (await smite.getGods('english')).download()
console.log(data) // => Array of all God data

Manually setting process environment

Both the credentials and sessions are stored in the user process environment. If using a package to set the environment such as dotenv, you can create a .env file to skip setting the credentials.

Here is an example .env file

HIREZDEVID=1004
HIREZAUTHKEY=23DF3C7E9BD14D84BF892AD206B6755C

The current active sessions are SMITESESSION, PALADINSSESSION and REALMROYALSESSION

const smiteSession = process.env.SMITESESSION
console.log(smiteSession) // => SESSION TOKEN

Contributing

Pull requests, issues and feature requests are all welcome

Copyright & License

This is an unofficial wrapper not affiliated or maintained by Hi-Rez Studios. Don't contact them regarding issues with this package. The package is covered with the MIT license

1.0.1

2 years ago

1.0.0

2 years ago