Top Firearms
Returns the firearms that lead a single measurable stat. Records missing the underlying measurement are excluded rather than ranked as zero.
- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- stringerforderlich
Which superlative to rank by
- Akzeptiert
- Beispiel
- string
Restrict the ranking to a category slug
- Beispiel
- integerstandard
10How many to return
- Bereich
- 1 – 25
- Beispiel
- TopFirearm[]
The response payload.
- string
Slug of the firearm.
- string
Display name, as the maker writes it.
- string | null
Slug of the manufacturer that makes it. Resolve against
/v1/manufacturers/{id}. - string | null
Slug of the category it belongs to. Resolve against
/v1/categories. - number | null
The figure this ranking is by, in the unit of whichever statistic was requested.
- string
One of g, m, rpm, mm, rounds, J
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Requires Builder tier or higher.
Valid stats: lightest, heaviest, longest-range, highest-rof, most-compact, highest-capacity, most-powerful.
The value field unit depends on the stat (grams for weight, meters for range, RPM for ROF, rounds for capacity, joules for power).
- 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.
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.