bser.js

이터널 리턴 API 래퍼

빠른 시작

bun install bser.js

import {BserClient, Language, MatchingMode, MatchingTeamMode, RegionServerCode} from "bser.js";

const client = new BserClient({apiKey: "your-api-key"});

// 닉네임으로 유저 검색
const user = await client.user.getByNickname("닉네임");

// 최근 게임 기록 (최대 90일)
const games = await client.user.getGames(user.uid);

// 상위 랭커 조회
const top = await client.ranking.getTop(33, MatchingTeamMode.Squad);

// 언어 데이터 다운로드 경로
const {l10Path} = await client.data.getLanguage(Language.Korean);

옵션

| 옵션 | 필수 | 기본값 | 설명 | |-----------|--------|---------|--------------------| | apiKey | 예 | - | API 키 | | timeout | 아니오 | 10000 | 요청 타임아웃 (ms) |

API 구성

| 모듈 | 메서드 | |------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | client.data | getGameDataHash(), getGameData<T>(metaType), getLanguage(language), getWeaponRoutes(routeId?), getWeaponRouteDesc(routeId) | | client.ranking | getTop(seasonId, matchingTeamMode), getTopByServer(seasonId, matchingTeamMode, serverCode) | | client.user | getByNickname(nickname), getGames(uid), getRank(userId, seasonId, matchingTeamMode), getStats(userId, seasonId, matchingMode), getUnionTeam(userId, seasonId) | | client.match | getById(gameId) |

전체 내용은 API 레퍼런스 를 참조하세요.

에러 처리

모든 메서드는 API 응답 code가 200이 아닌 경우 BserApiError 를 throw 합니다:

import {BserApiError} from "bser.js";

try {
    const user = await client.user.getByNickname("존재하지_않는_닉네임");
} catch (e) {
    if (e instanceof BserApiError) {
        console.log(e.code);       // 404
        console.log(e.apiMessage); // "..."
    }
}

| Code | 의미 | |------|--------------------| | 200 | 성공 | | 400 | 파라미터 오류 | | 403 | 금지 / 레이트 리밋 | | 404 | 찾을 수 없음 | | 429 | 요청 과다 | | 500 | 서버 오류 |

테스트

BSER_API_KEY=your-key bun test

통합 테스트는 실제 API 요청을 보내며, data → ranking → user → match 순서로 체인 실행됩니다.

문서

• API 레퍼런스
• 타입
• 상수