r6-info.js

2.2.0 • Public • Published

R6-INFO.js

A simple wrapper for the Rainbow Six Siege API that allows you to easily retrieve information about maps, operators, ranks, seasons, charms and service status.

Installation

npm install r6info.js
npm i r6-info.js

userId

The R6-INFO.js package requires a user ID to be provided when calling its methods. The user ID is used to associate the generated access tokens with a specific user, allowing for personalized and secure access to the Rainbow Six Siege API.

Getting an Access Token

The Token Manager is a crucial module in R6-INFO.js that handles the authentication process required to access the Rainbow Six Siege API. It provides functions for generating, validating, and clearing access tokens.

Generating a Token

Before making any requests to the API, you need to generate an access token. The generateToken() function in the tokenManager module takes care of this for you. Here's an example of how to use it:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    console.log('Token generated successfully');
  } catch (error) {
    console.error('Error while generating token:', error.message);
  }
}

main();

This function sends a request to the API to obtain a new access token. If the request is successful, the token is stored internally and can be used for subsequent API requests. If an error occurs during the token generation process, it will be caught and logged to the console.

Getting the Current Token

If you need to retrieve the current access token, you can use the getToken() function provided by the tokenManager module. Here's an example:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    const token = await r6Info.tokenManager.getToken(userId);
    console.log('Token:', token);
  } catch (error) {
    console.error('Error while getting token:', error.message);
  }
}

main();

The getToken() function returns an object containing the current access token and the corresponding call ID. The call ID is a unique identifier associated with each API request and can be useful for debugging or tracking purposes.

Checking Token Validity

To ensure that the access token is still valid before making an API request, you can use the isValidToken() function. It checks the expiration time of the token and returns a boolean indicating whether the token is still valid or not. Here's an example:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    const token = await r6Info.tokenManager.getToken(userId);
    const isValid = await r6Info.tokenManager.isValidToken(token, userId);

    if (isValid) {
      console.log('Token is valid');
    } else {
      console.log('Token is expired or invalid');
    }
  } catch (error) {
    console.error('Error while checking token validity:', error.message);
  }
}

main();

If the token is valid, the function will return true, and you can proceed with making API requests. If the token is expired or invalid, you should generate a new token using the generateToken() function before attempting to make any requests.

Getting Rank Information

The getRanks() function supports retrieving rank information across different versions of the game's ranking system, from v1 to v6. This flexibility allows users to query rank data that aligns with specific game seasons or ranking system updates. Here are examples demonstrating how to use the getRanks() function for each version, including filtering options for min_mmr and max_mmr.

v1: Until Y1S3 | #3 | Skull Rain

v2: Y1S4 | #4 | Red Crow

v3: Y2S1 - Y4S2 | #5 - #14 | Velvet Shell - Phantom Sight

v4: Y4S3 - Y6S2 | #15 - #22 | Ember Rise - North Star

v5: Y6S3 - Y7S3 | #23 - #27 | Crystal Guard - Brutal Swarm

V6: Y7S4+ | #28+ | Solar Raid+ (Ranked 2.0)

Version 1 (v1)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV1 = await r6Info.getRanks(userId, { version: 'v1' });
    console.log('All ranks for version v1:', ranksV1);

    const filteredRanksV1 = await r6Info.getRanks(userId, { min_mmr: 2000, max_mmr: 2500, version: 'v1' });
    console.log('Filtered ranks for version v1:', filteredRanksV1);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

In this example, we first generate an access token using the generateToken() function. Then, we call the getRanks() function with the version parameter set to 'v1' to retrieve all ranks for version 1 of the ranking system. We also demonstrate filtering the ranks by specifying the min_mmr and max_mmr parameters to get ranks within a specific MMR range.

Version 2 (v2)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV2 = await r6Info.getRanks(userId, { version: 'v2' });
    console.log('All ranks for version v2:', ranksV2);

    const filteredRanksV2 = await r6Info.getRanks(userId, { min_mmr: 2600, max_mmr: 3100, version: 'v2' });
    console.log('Filtered ranks for version v2:', filteredRanksV2);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

Similar to version 1, this example retrieves all ranks for version 2 of the ranking system and demonstrates filtering the ranks based on MMR range.

The examples for versions 3 to 6 follow the same pattern, with the only difference being the version parameter value and the specific MMR ranges used for filtering.

Version 3 (v3)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV3 = await r6Info.getRanks(userId, { version: 'v3' });
    console.log('All ranks for version v3:', ranksV3);

    const filteredRanksV3 = await r6Info.getRanks(userId, { min_mmr: 3200, max_mmr: 3700, version: 'v3' });
    console.log('Filtered ranks for version v3:', filteredRanksV3);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

Version 4 (v4)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV4 = await r6Info.getRanks(userId, { version: 'v4' });
    console.log('All ranks for version v4:', ranksV4);

    const filteredRanksV4 = await r6Info.getRanks(userId, { min_mmr: 3800, max_mmr: 4300, version: 'v4' });
    console.log('Filtered ranks for version v4:', filteredRanksV4);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

Version 5 (v5)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV5 = await r6Info.getRanks(userId, { version: 'v5' });
    console.log('All ranks for version v5:', ranksV5);

    const filteredRanksV5 = await r6Info.getRanks(userId, { min_mmr: 4400, max_mmr: 4900, version: 'v5' });
    console.log('Filtered ranks for version v5:', filteredRanksV5);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

Version 6 (v6)

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);
    
    const ranksV6 = await r6Info.getRanks(userId, { version: 'v6' });
    console.log('All ranks for version v6:', ranksV6);

    const filteredRanksV6 = await r6Info.getRanks(userId, { min_mmr: 5000, max_mmr: 5500, version: 'v6' });
    console.log('Filtered ranks for version v6:', filteredRanksV6);
    
  } catch (error) {
    console.error('Error while requesting ranks:', error.message);
  }
}

main();

Getting Service Status

The getServiceStatus() function allows you to retrieve the current status of the Rainbow Six Siege game servers. This information can be useful for monitoring the health and availability of the game service. Here's an example of how to use the getServiceStatus() function:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);

    const serviceStatus = await r6Info.getServiceStatus(userId);
    console.log('Service status:', serviceStatus);
    
  } catch (error) {
    console.error('Error while requesting service status:', error.message);
  }
}

main();

Getting Map Information

The getMaps() function allows you to retrieve information about the maps available in Rainbow Six Siege. You can get a list of all maps or filter the maps based on specific criteria. Here's an example of how to use the getMaps() function:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);

    // Get all maps
    const maps = await r6Info.getMaps(userId);
    console.log('All maps:', maps);
    
    // Filter maps by name
    const filteredMapsByName = await r6Info.getMaps(userId, { name: 'Bank' });
    console.log('Maps filtered by name:', filteredMapsByName);
    
    // Filter maps by location
    const filteredMapsByLocation = await r6Info.getMaps(userId, { location: 'USA' });
    console.log('Maps filtered by location:', filteredMapsByLocation);
    
    // Filter maps by release date
    const filteredMapsByReleaseDate = await r6Info.getMaps(userId, { releaseDate: '2015-12-01' });
    console.log('Maps filtered by release date:', filteredMapsByReleaseDate);
    
    // Filter maps by playlists
    const filteredMapsByPlaylists = await r6Info.getMaps(userId, { playlists: 'ranked' });
    console.log('Maps filtered by playlists:', filteredMapsByPlaylists);
    
    // Filter maps by rework status
    const filteredMapsByRework = await r6Info.getMaps(userId, { mapReworked: true });
    console.log('Maps filtered by rework status:', filteredMapsByRework);
    
  } catch (error) {
    console.error('Error while requesting maps:', error.message);
  }
}

main();

In this example, we first generate an access token using the generateToken() function. Then, we demonstrate various ways to use the getMaps() function:

Retrieving all maps by calling getMaps() without any parameters. Filtering maps by name using the name parameter. Filtering maps by location using the location parameter. Filtering maps by release date using the releaseDate parameter. Filtering maps by playlists using the playlists parameter. Filtering maps by rework status using the mapReworked parameter. You can use these filtering options individually or combine them to retrieve specific subsets of maps based on your requirements.

Getting Operator Information

The getOperators() function allows you to retrieve information about the operators available in Rainbow Six Siege. You can get a list of all operators or filter the operators based on specific criteria. Here's an example of how to use the getOperators() function:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);

    // Get all operators
    const operators = await r6Info.getOperators(userId);
    console.log('All operators:', operators);
    
    // Filter operators by name
    const filteredOperatorsByName = await r6Info.getOperators(userId, { name: 'Ash' });
    console.log('Operators filtered by name:', filteredOperatorsByName);
    
    // Filter operators by safe name
    const filteredOperatorsBySafeName = await r6Info.getOperators(userId, { safename: 'recruit' });
    console.log('Operators filtered by safe name:', filteredOperatorsBySafeName);
    
    // Filter operators by real name
    const filteredOperatorsByRealName = await r6Info.getOperators(userId, { realname: 'Eliza Cohen' });
    console.log('Operators filtered by real name:', filteredOperatorsByRealName);
    
    // Filter operators by birthplace
    const filteredOperatorsByBirthplace = await r6Info.getOperators(userId, { birthplace: 'Jerusalem, Israel' });
    console.log('Operators filtered by birthplace:', filteredOperatorsByBirthplace);
    
    // Filter operators by age
    const filteredOperatorsByAge = await r6Info.getOperators(userId, { age: 33 });
    console.log('Operators filtered by age:', filteredOperatorsByAge);
    
    // Filter operators by date of birth
    const filteredOperatorsByDateOfBirth = await r6Info.getOperators(userId, { date_of_birth: '1984-12-24' });
    console.log('Operators filtered by date of birth:', filteredOperatorsByDateOfBirth);
    
    // Filter operators by season introduced
    const filteredOperatorsBySeasonIntroduced = await r6Info.getOperators(userId, { season_introduced: 'Y1S1' });
    console.log('Operators filtered by season introduced:', filteredOperatorsBySeasonIntroduced);
    
    // Filter operators by health
    const filteredOperatorsByHealth = await r6Info.getOperators(userId, { health: 1 });
    console.log('Operators filtered by health:', filteredOperatorsByHealth);
    
    // Filter operators by speed
    const filteredOperatorsBySpeed = await r6Info.getOperators(userId, { speed: 3 });
    console.log('Operators filtered by speed:', filteredOperatorsBySpeed);

    // Filter operators by unit
    const filteredOperatorsByUnit = await r6Info.getOperators(userId, { unit: 'FBI SWAT' });
    console.log('Operators filtered by unit:', filteredOperatorsByUnit);

    // Filter operators by country code
    const filteredOperatorsByCountryCode = await r6Info.getOperators(userId, { country_code: 'US' });
    console.log('Operators filtered by country code:', filteredOperatorsByCountryCode);

    // Filter operators by roles
    const filteredOperatorsByRoles = await r6Info.getOperators(userId, { roles: 'attacker' });
    console.log('Operators filtered by roles:', filteredOperatorsByRoles);

    // Filter operators by side
    const filteredOperatorsBySide = await r6Info.getOperators(userId, { side: 'attacker' });
    console.log('Operators filtered by side:', filteredOperatorsBySide);
    } catch (error) {
    console.error('Error while requesting operators:', error.message);
    }
  }

main();

In this example, we first generate an access token using the generateToken() function. Then, we demonstrate various ways to use the getOperators()function:

  1. Retrieving all operators by calling getOperators() without any parameters.
  2. Filtering operators by name using the name parameter.
  3. Filtering operators by safe name using the safename parameter.
  4. Filtering operators by real name using the realname parameter.
  5. Filtering operators by birthplace using the birthplace parameter.
  6. Filtering operators by age using the age parameter.
  7. Filtering operators by date of birth using the date_of_birth parameter.
  8. Filtering operators by season introduced using the season_introduced parameter.
  9. Filtering operators by health using the health parameter.
  10. Filtering operators by speed using the speed parameter.
  11. Filtering operators by unit using the unit parameter.
  12. Filtering operators by country code using the country_code parameter.
  13. Filtering operators by roles using the roles parameter.
  14. Filtering operators by side using the side parameter.

These filtering options provide flexibility in retrieving specific subsets of operators based on various criteria. You can use them individually or combine them to narrow down the results according to your needs.

Getting Season Information

The getSeasons() function allows you to retrieve information about the seasons in Rainbow Six Siege. You can get a list of all seasons or filter the seasons based on specific criteria. Here's an example of how to use the getSeasons() function:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);

    // Get all seasons
    const seasons = await r6Info.getSeasons(userId);
    console.log('All seasons:', seasons);

    // Filter seasons by name
    const filteredSeasonsByName = await r6Info.getSeasons(userId, { name: 'Black Ice' });
    console.log('Seasons filtered by name:', filteredSeasonsByName);

    // Filter seasons by map
    const filteredSeasonsByMap = await r6Info.getSeasons(userId, { map: 'Yacht' });
    console.log('Seasons filtered by map:', filteredSeasonsByMap);

    // Filter seasons by operators
    const filteredSeasonsByOperators = await r6Info.getSeasons(userId, { operators: 'Buck, Frost' });
    console.log('Seasons filtered by operators:', filteredSeasonsByOperators);

    // Filter seasons by weapons
    const filteredSeasonsByWeapons = await r6Info.getSeasons(userId, { weapons: 'C8-SFW, Super 90' });
    console.log('Seasons filtered by weapons:', filteredSeasonsByWeapons);

    // Filter seasons by description
    const filteredSeasonsByDescription = await r6Info.getSeasons(userId, { description: 'Operation Black Ice brings a new map and two new operators to the game.' });
    console.log('Seasons filtered by description:', filteredSeasonsByDescription);

    // Filter seasons by code
    const filteredSeasonsByCode = await r6Info.getSeasons(userId, { code: 'Y1S1' });
    console.log('Seasons filtered by code:', filteredSeasonsByCode);

    // Filter seasons by start date
    const filteredSeasonsByStartDate = await r6Info.getSeasons(userId, { startDate: '2016-02-02' });
    console.log('Seasons filtered by start date:', filteredSeasonsByStartDate);
    
  } catch (error) {
    console.error('Error while requesting seasons:', error.message);
  }
}

main();

In this example, we first generate an access token using the generateToken() function. Then, we demonstrate various ways to use the getSeasons() function:

Retrieving all seasons by calling getSeasons() without any parameters. Filtering seasons by name using the name parameter. Filtering seasons by map using the map parameter. Filtering seasons by operators using the operators parameter. Filtering seasons by weapons using the weapons parameter. Filtering seasons by description using the description parameter. Filtering seasons by code using the code parameter. Filtering seasons by start date using the startDate parameter. These filtering options allow you to retrieve specific seasons based on different criteria. You can use them individually or combine them to get the desired subset of seasons.

Getting Attachment Information

The getAttachment() function allows you to retrieve information about the attachments available in Rainbow Six Siege. You can get a list of all attachments or filter the attachments based on specific criteria. Here's an example of how to use the getAttachment() function:

const r6Info = require('r6-info.js');

async function main() {
  const userId = 'your-user-id';

  try {
    await r6Info.tokenManager.generateToken(userId);

    // Get all attachments
    const attachments = await r6Info.getAttachment(userId);
    console.log('All attachments:', attachments);
    
    // Filter attachments by name
    const filteredAttachmentsByName = await r6Info.getAttachment(userId, { name: 'Red Dot Sight' });
    console.log('Attachments filtered by name:', filteredAttachmentsByName);
    
    // Filter attachments by style
    const filteredAttachmentsByStyle = await r6Info.getAttachment(userId, { style: 'colour' });
    console.log('Attachments filtered by style:', filteredAttachmentsByStyle);
    
    // Filter attachments by rarity
    const filteredAttachmentsByRarity = await r6Info.getAttachment(userId, { rarity: 'common' });
    console.log('Attachments filtered by rarity:', filteredAttachmentsByRarity);
    
    // Filter attachments by availability
    const filteredAttachmentsByAvailability = await r6Info.getAttachment(userId, { availability: 'removed' });
    console.log('Attachments filtered by availability:', filteredAttachmentsByAvailability);
    
    // Filter attachments by bundle
    const filteredAttachmentsByBundle = await r6Info.getAttachment(userId, { bundle: '"Crimson Heist Battlepass"' });
    console.log('Attachments filtered by bundle:', filteredAttachmentsByBundle);
    
    // Filter attachments by season
    const filteredAttachmentsBySeason = await r6Info.getAttachment(userId, { season: '"North Star"' });
    console.log('Attachments filtered by season:', filteredAttachmentsBySeason);
    
  } catch (error) {
    console.error('Error while requesting attachments:', error.message);
  }
}

main();

In this example, we first generate an access token using the generateToken() function. Then, we demonstrate various ways to use the getAttachment() function:

Retrieving all attachments by calling getAttachment() without any parameters. Filtering attachments by name using the name parameter. Filtering attachments by style using the style parameter. Filtering attachments by rarity using the rarity parameter. Filtering attachments by availability using the availability parameter. Filtering attachments by bundle using the bundle parameter. Filtering attachments by season using the season parameter. These filtering options provide flexibility in retrieving specific subsets of attachments based on various criteria. You can use them individually or combine them to narrow down the results according to your needs.

Error Handling

The package functions throw an exception if an error occurs during API requests. Make sure to handle errors appropriately using try-catch blocks.

If the access token has expired or is invalid, an exception will be thrown with the message "Token expired or invalid". In this case, you need to obtain a new token using the getToken() function.

License

This package is fan made, so it has been created for only informational purposes

Readme

Keywords

none

Package Sidebar

Install

npm i r6-info.js

Weekly Downloads

17

Version

2.2.0

License

ISC

Unpacked Size

34.9 kB

Total Files

14

Last publish

Collaborators

  • mazeor