Documentation / @blizzard-api/sc2
@blizzard-api/sc2
This package aims to make it easier for you to integrate with the Blizzard Battle.net API, specifically for StarCraft II.
Installation
npm i @blizzard-api/core @blizzard-api/sc2Usage
You can get paths, namespaces, parameters and more for a specific endpoint by calling it from the sc2 export.
import { sc2 } from "@blizzard-api/sc2"
//or
import sc2 from "@blizzard-api/sc2"
const season = sc2.season("eu");
^ { endDate: string; number: number; seasonId: number; startDate: string; year: number; }If you don't want to use the exported sc2 object, you can also access the functions directly:
import { season } from "@blizzard-api/sc2"
const seasonI = season("eu");
^ { endDate: string; number: number; seasonId: number; startDate: string; year: number; }Types
If you need the response types, they are also exported with "Response" appended, so to get the response type from the above code, you can import it like this:
import type { SeasonResponse } from '@blizzard-api/sc2';If you simply want to use the existing object, you can use the helper, ExtractResourceType, from @blizzard-api/core like so:
import { sc2 } from "@blizzard-api/sc2"
const season = sc2.season("eu");
^ { endDate: string; number: number; seasonId: number; startDate: string; year: number; }
type SeasonResponse = ExtractResourceType<typeof season>;Notes on Types
The types are manually created from using the Blizzard API documentation, and are as accurate as possible with smoke testing each endpoint. However, no-one is perfect so there is likely to be some discrepancies. If you encounter any issues with the types from this package, please open an issue or a pull request.
Client
While this package is made to function on it's own, it performs even better when combined with @blizzard-api/client where you can easily request data combining the two libraries.
import { createBlizzardApiClient } from '@blizzard-api/client';
import { sc2 } from '@blizzard-api/sc2';
const client = await createBlizzardApiClient({
key: process.env.BLIZZARD_CLIENT_ID!,
secret: process.env.BLIZZARD_CLIENT_SECRET!,
origin: 'eu',
});
//Response will automatically be typed with the appropriate values
const response = await client.sendRequest(sc2.season("eu"));
console.log(response);
^ typeof SeasonResponse | undefinedModules
Interfaces
- GrandmasterLeaderboardResponse
- LadderResponse
- LadderSummaryResponse
- LeagueDataResponse
- LegacyAchievementsResponse
- LegacyLaddersResponse
- LegacyMatchHistoryResponse
- LegacyProfileResponse
- LegacyRewardsResponse
- MetadataResponse
- ProfileResponse
- SeasonResponse
- SingleLegacyLadderResponse
- StaticProfileResponse
Type Aliases
Variables
Functions
- getLeagueData
- grandmasterLeaderboard
- ladder
- ladderSummary
- legacyAchievements
- legacyLadder
- legacyLadders
- legacyMatchHistory
- legacyProfile
- legacyRewards
- metadata
- player
- profile
- season
- staticProfile
References
default
Renames and re-exports sc2