GunSpec

Favorites

The signed-in account's favourited firearms. Session-scoped: these call /v1/me/* and answer 401 without a key that belongs to a user account. A favourite is a slug, not a copy of the record, so a firearm renamed in the catalog stays favourited.

Authentifizierung erforderlichExplorer+

client.favorites.listIds()

List just the ids of your favorited firearms. Cheaper than list when you only need to render a filled/unfilled state across a grid.

listIds(): Promise<APIResponse<{ ids: string[] }>>
GET/v1/me/favorites/ids

Explorer+

  • stringHeadererforderlich

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

application/json

  • object

    The response payload.

  • string[]

    Slugs of every firearm you have favorited, newest first.

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

Alle Anfragelimits

Mindeststufe
Explorer+
Monatskontingent
200/mo
Anfragerate
10/min
Tageslimit
50

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