client.firearms.filterOptions()
Get available filter options for the firearms list endpoint. Returns distinct values for manufacturers, calibers, categories, action types, countries, and statuses that can be used as filter values.
filterOptions(): Promise<APIResponse<FilterOptions>>- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- object
The distinct filter values currently present in the catalog.
- object[]
Manufacturers with at least one firearm.
- string
Slug of the manufacturer, and the value to send as
manufacturer. - string
Display name, as the maker writes it.
- string | null
ISO 3166-1 alpha-2 code of where they are based, for grouping the list by country.
- object[]
Categories with at least one firearm.
- string
Slug of the category, and the value to send as
category. Keyedslughere rather thanid, unlike the other lists. - string
Display name, as the maker writes it.
- object[]
Cartridges chambered by at least one firearm.
- string
Slug of the cartridge, and the value to send as
caliber. - string
Display name, as the maker writes it.
- object[]
Operating actions present in the catalog.
- string
The action type as stored, and the value to send as
action_type. - string
Display name, as the maker writes it.
- object[]
JSON array of notable features, as a string. The same vocabulary
/v1/firearms/by-featurefilters on. - string
The feature as stored, and the value to send as
featureto /v1/firearms/by-feature. - string
Display name, as the maker writes it.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
- 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.
Dieser Aufruf beantwortet bedingte Anfragen. Speichern Sie das ETag einer Antwort und senden Sie es als If-None-Match zurueck: ein unveraenderter Datensatz liefert 304 Not Modified ohne Body. Das zaehlt auf Ihr Minutenlimit, aber nicht auf Ihr Tageskontingent.