Skip to content
This repository has been archived by the owner on Feb 22, 2024. It is now read-only.
/ pubg.ts Public archive

πŸ” A lightweight PUBG API wrapper written in TypeScript

License

Notifications You must be signed in to change notification settings

NuroDev/pubg.ts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation



πŸ”
pubg.ts




A lightweight PUBG TypeScript API Wrapper

Tests Package Version Package Monthly Downloads API

✨ Features

  • ❗ Stirctly typed
  • ⚑ Request batching
  • ✍️ Verbose documentation
  • πŸͺ Hooks support
  • ⚠️ Error handling

πŸš€ Install

Install it locally in your project

npm i --save pubg.ts

# Or with Yarn

yarn add pubg.ts

For use in the browser, check out the following:

πŸ¦„ Usage

Sign for a developer account

You'll first need to sign up on the PUBG developer API site. Using this account you can create a API token

Register an app

With an account created, you can create a new developer application that will provide you with your API key.

Make something!

Here's a few small examples of what you can do with this library

import { Client, Shard } from "pubg.ts";

const client = new Client({
  apiKey: "your_key_goes_here",
  shard: Shard.STEAM, // Optional (Default: Steam)
});

// Get a single or multiple player(s) using their name or ID
const { data: player } = await api.getPlayer({
  skipFailed: false, // Optional: fail silently (Default: false)
  value: "single_name_or_id_or_array_of_such",
});

// Fetch a data from a single match
const { data: match } = await client.getMatch({
  id: "a036c694-be29-4dea-833d-b6ff84323de7",
});

// Get the current active season
const { data: activeSeason } = await client.getSeason();

// Get season stats for a specific player
const { data: playerSeason } = await client.getPlayerSeason({
  player: player.id,
  season: activeSeason,
  ranked: false, // Optionally gets stats for ranked gamemodes
});

Using individual fetchers

import { Shard, getPlayer, getMatch, getSeason } from "pubg.ts";

// Get a single or multiple player(s) using their name or ID
const { data: player } = await getPlayer({
  apiKey: "your_key_goes_here",
  shard: Shard.STEAM, // Optional: for all hooks (Default: Steam)
  skipFailed: false, // Optional: fail silently (Default: false)
  value: "single_name_or_id_or_array_of_such",
});

// Fetch a data from a single match
const { data: match } = await getMatch({
  apiKey: "your_key_goes_here",
  id: "a036c694-be29-4dea-833d-b6ff84323de7",
});

// Get the current active season
const { data: activeSeason } = await getSeason({
  apiKey: "your_key_goes_here",
});

// Get season stats for a specific player
const { data: playerSeason } = await getPlayerSeason({
  apiKey: "your_key_goes_here",
  player: player.id,
  season: activeSeason,
  ranked: false, // Optionally gets stats for ranked gamemodes
});

❀️ Credits