GunSpec

Game

Resource class for interacting with the GunSpec Game API. Wraps all /v1/game endpoints. These endpoints provide game-balanced firearm data suitable for game development, including normalized stats, tier rankings, and balance analysis. Instantiated internally by the GunSpec client and exposed as client.game.

Authentifizierung erforderlichBuilder+

Get a roster of firearms best suited for a specific game role.

roleRoster(params: RoleRosterParams): Promise<APIResponse<RoleRosterItem[]>>
GET/v1/game/role-roster

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • stringerforderlich

    Gameplay role

    Akzeptiert
    Beispiel
  • integerstandard5

    How many to return

    Bereich
    1 – 25
    Beispiel

  • object[]

    The best-scoring firearms for the role, strongest first.

  • string

    Slug of the firearm.

  • string

    Display name, as the maker writes it.

  • number

    Fit for this role, 0 to 100, from the role weighting of the game stats.

  • object

    The editorial game stats, with the game prefix the column carries stripped.

  • integer | null

    Editorial damage rating, 0-100. Not a measured figure.

  • integer | null

    Editorial accuracy rating, 0-100.

  • integer | null

    Editorial range rating, 0-100.

  • integer | null

    Editorial rate-of-fire rating, 0-100.

  • integer | null

    Editorial mobility rating, 0-100.

  • integer | null

    Editorial recoil-control rating, 0-100.

  • integer | null

    Editorial reload-speed rating, 0-100.

  • integer | null

    Editorial concealment rating, 0-100.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.