Firearms

Your API key. Authorization: Bearer <key> is accepted in its place.

Resource slug ID

Accepts

a lowercase slug: letters, digits and hyphens

Example

glock-17-gen5

Which asset: a kind, which resolves to the primary asset of that kind, or the numeric id of one row from /v1/firearms/{id}/media. Addressing by kind means never having to list first just to learn an id.

Accepts

silhouetterenderphotoschematicmodelor a numeric id

Example

render

Bytes, an inline data URI, or metadata only

Accepts

rawdataurijson

Example

raw

Pre-rendered derivative; falls back to the original when absent

Accepts

fulldisplaythumb

Example

full

Silhouettes only: inject a stroke so line art reads on any background

Range

0 – 20

Example

0

Silhouettes only: stroke colour. Any CSS colour the browser understands; quotes, angle brackets, ampersands and backslashes are refused, because the value is written into an SVG attribute

Max length

64

Example

white

One asset belonging to a firearm. Every kind, whether silhouette, render, photo, schematic or 3D model, is returned in this same shape, and url is always absolute and directly fetchable.

Null for assets stored as a column rather than a row (the 3D model).

What kind of asset a media row is.

Media type of the bytes, e.g. image/png.

Pixel width, where it is known.

Pixel height, where it is known.

Alt text, where one has been written. Null otherwise, so do not render an empty string.

Absolute, directly fetchable URL.

Per-size URLs. Absent on assets we link rather than host.

URL of the asset at full size.

URL of the mid-size rendition, for a detail page.

URL of the thumbnail rendition, for a list or grid.

Attribution required to reuse the asset. Populated wherever the catalogue records it.

Where the record came from: a curated entry, an inference, or an import.

Who made the asset, where it is credited.

Page the asset or document was taken from.

Licence the asset is held under, where one is recorded.