Calibers

• X-API-KeystringHeadererforderlich

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

• idstringerforderlich

  Caliber slug

  Akzeptiert

  a lowercase slug: letters, digits and hyphens

  Beispiel

  9x19mm-parabellum

Das Beispiel fragt 9x19mm-parabellum ab. Diesen Datensatz auf gunspec.io ansehen, für Menschen dargestellt.

• pageintegerstandard1

  Page number, from 1 to 10,000

  Bereich

  1 – 10000

  Beispiel

  1

• per_pageintegerstandard20

  Items per page (max 100)

  Bereich

  1 – 100

  Beispiel

  20

• dataAmmunitionLoad[]

  A specific factory ammunition load within a caliber.

• data[].idstring

  URL-safe slug identifying the load, e.g. 9mm-124gr-fmj.

• data[].caliberIdstring

  Slug of the cartridge. Resolve against /v1/calibers/{id}.

• data[].namestring

  Display name, as the maker writes it.

• data[].designationstring | null

  Military or standards designation for the load, e.g. M882.

• data[].manufacturerstring | null

  Who makes it.

• data[].countryOfOriginstring | null

  ISO 3166-1 alpha-2 code of where it was designed, e.g. AT.

• data[].bulletWeightGnumber

  Bullet weight in grams. Divide by 0.0648 for grains.

• data[].bulletTypestring

  Bullet construction: fmj, jhp, sp, match.

• data[].ballisticCoefficientG1number | null

  Ballistic coefficient against the G1 drag model, the convention for flat-based bullets.

• data[].ballisticCoefficientG7number | null

  Ballistic coefficient against the G7 drag model, which fits boat-tail rifle bullets better than G1.

• data[].referenceVelocityMpsnumber

  Muzzle velocity in metres per second at the reference barrel length below, not at the barrel of any particular firearm.

• data[].referenceBarrelLengthMmnumber

  Barrel length in millimetres the reference velocity was measured from. Velocity for another barrel is extrapolated from this pair.

• data[].sectionalDensitynumber | null

  Bullet mass divided by the square of its diameter. Higher penetrates better, all else equal.

• data[].yearIntroducedinteger | null

  Year it entered production or service. Null where the date is disputed or unknown.

• data[].isCommoninteger

  1 when the load is commonly stocked.

• data[].bulletSvgUrlstring | null

  Absolute URL of the rendered bullet diagram.

• data[].velocityRetentionExponentnumber | null

  Decay exponent used when extrapolating velocity to a barrel length other than the reference one.

• data[].descriptionstring | null

  Prose summary of the record, where one has been written.

• data[].isMilitaryinteger

  1 when the load is a military issue round.

• data[].createdAtstring

  When the record was first added, YYYY-MM-DD HH:MM:SS in UTC.

• data[].updatedAtstring

  When a field we serve last changed. Maintained by the database rather than by whatever wrote the row, so it moves for a corrected figure and does not move for a re-run of the seed. Before migration 0113 the seed rewrote every load on every run, and this said so.

• data[].sourcesstring[]

  Where the figures came from. Null on every load today: this family has somewhere to cite from and nothing cited yet, which the data quality page counts as a gap rather than hiding. Check a velocity against the maker until it is filled.

• data[].dataConfidencenumber | null

  How well specified the load is, on the same 0 to 1 scale as a firearm's. Null until there are sources behind it: a confidence figure with nothing supporting it looks like evidence and is not.

• data[].provenanceProvenance

  Where a record's figures came from and how far they have been checked, in one place. sources are the pages consulted; check a specific figure against those. sourceKinds says what each page is and bestSourceKind the strongest of them, on the hierarchy SourceKind defines: a maker or standards-body page is evidence for a figure, a retailer or forum page is evidence the item exists. dataConfidence is the 0 to 1 score set from what was actually sourced and never raised by hand. verifiedAt and verifiedFields say when a source was last read against the record and which fields it stated; null means the row is still seed knowledge. updatedAt and version are the same cache signals the record carries at the top level.

• data[].provenance.sourcesstring[]

  The pages consulted when the record was compiled, as an array. Check a specific figure against these rather than against dataConfidence.

• data[].provenance.sourceKindsobject[]

  What each cited page is, in sources order, on the SourceKind hierarchy. A host not in the source map is other, never guessed.

• data[].provenance.bestSourceKindSourceKind | null

  The strongest kind among the citations, or null when nothing is cited. manufacturer or standards_body means a figure can be checked against an authority; retailer or community alone means the record is still supported by copies of copies.

• data[].provenance.makerSourcestring | null

  The first cited page on the record's own manufacturer's website, or null when it cites none. A page on another maker's site does not count. Cited from the maker is not the same as checked against it: verifiedFields names the figures that were read against a source.

• data[].provenance.evidencestring

  How far the record's figures are backed, strongest first, for a badge: verified when at least one figure was read against a source (verifiedFields), maker when it cites a page on its own manufacturer's site (makerSource), authority when it cites a maker, standards body or government page, secondary when it cites only press, retailers, references or forums, none when it cites nothing. Derived from the fields beside it.

• data[].provenance.checksobject

  The checks the record has been through, on a single record's response only: every task the data agent (Redback) or a person was given about it, what each proposed, the pages it read, and whether a person accepted it. Nothing an agent proposes reaches the record until a person accepts it, so this is the trail behind verifiedFields. Who reviewed is not published; an agent's instance name is.

• data[].provenance.dataConfidencenumber | null

  The 0 to 1 score set from what was actually sourced, never raised by hand. See the confidence bands in the docs.

• data[].provenance.verifiedAtstring | null

  When a source was last read against this record. Null means the row is still seed knowledge.

• data[].provenance.verifiedFieldsstring[]

  Which fields the source stated, as an array. Everything else on a verified row is still unverified. Null where no source has been read.

• data[].provenance.specSourcestring | null

  Cartridges only: the page the drawing figures were taken from. Null on every other kind of record.

• data[].provenance.updatedAtstring

  When a served column last changed; the same value the record carries at the top level.

• data[].provenance.versionstring | null

  The record's content version, equal to the top-level version; equal versions mean equal data.

• data[].versionstring | null

  Opaque fingerprint of this record. It changes when and only when a field we serve changes, so a client holding the same value already has the record and need not fetch it. Equality is the only supported operation: do not parse it, and do not assume how it is computed. Null means the record has not been written since versioning began, not that it is unchanged.

• pagination.pagenumber

  Current page number

• pagination.per_pagenumber

  Items per page

• pagination.totalnumber

  Total matching records (Builder and above)

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