GunSpec

My Favorites

Save and manage your personal list of favorite firearms. Favorites are scoped to your API key and persist across sessions.

Authentifizierung erforderlichExplorer+

Add Favorite

Adds a firearm to your favorites. Idempotent: adding twice is not an error.

POST/v1/me/favorites/{firearmId}

Explorer+

  • stringHeadererforderlich

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

  • stringerforderlich

    Firearm slug

    Beispiel

application/json

  • object

    The response payload.

  • boolean

    Always true: the firearm is in your favorites once this returns.

  • string

    Slug of the firearm this row belongs to.

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

Adding an already-favorited firearm is safe and returns the same response.

Use the firearm slug (e.g. glock-17-gen5) as the firearmId path parameter.

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.