La API de HumanToll

GET /api/v1/

What this API is, where to start, and the daily allowance

Parámetros: ninguno

GET /api/v1/products

The product catalogue; with a published run, each product's deaths per unit and per kg

Parámetros:

• tier — semi_finished or finished.
  uno de: semi_finished · finished
• category — A product category code, as each product's `category.code` gives it.
• sort — name, toll (deaths per kg on the material route), confidence or complete.
  uno de: name · toll · confidence · complete
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/product/{slug}

One product: both routes and both metrics, the bill of materials and the chain it reaches

Parámetros:

• slug (obligatorio) — The product's permanent slug, as in its page's address.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/product/{slug}/contributions

What carries one figure: its breakdown by material, country, conflict, channel or industry

Parámetros:

• slug (obligatorio) — The product's permanent slug, as in its page's address.
• metric — deaths or injuries.
  uno de: deaths · injuries
• method — material (the route through the bill of materials) or mrio (per €1,000).
  uno de: material · mrio
• type — One breakdown; all of the route's when absent.
  uno de: material · country · conflict · channel · sector
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/product/{slug}/explain

The audit trail of one figure: every stage, each summing to the headline

Parámetros:

• slug (obligatorio) — The product's permanent slug, as in its page's address.
• metric — deaths or injuries.
  uno de: deaths · injuries
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/compare

Two products drawn together: the interval of their ratio, and a verdict only where it holds

Parámetros:

• a (obligatorio) — The first product's slug.
• b (obligatorio) — The second product's slug.
• metric — deaths or injuries.
  uno de: deaths · injuries
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/spend

EU households' spending on each consumption category: the harm in €amount, grouped against all spending

Parámetros:

• category — A COICOP 2018 category code; all of them when absent.
• amount — Euros spent; every figure and its interval scale with it.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/material/{slug}

A raw material: who produces it, which products use it, and what it carries in a run

Parámetros:

• slug (obligatorio) — The material's permanent slug, as in its page's address.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/conflict/{slug}

A scored conflict: the deaths UCDP counted, the model's attribution, and the products it reaches

Parámetros:

• slug (obligatorio) — The conflict's permanent slug, as in its page's address.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/country/{iso3}

A country: the harm counted there, and the products it reaches

Parámetros:

• iso3 (obligatorio) — ISO 3166-1 alpha-3, in either case.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/channel/{code}

A harm channel: what it counts, how it is attributed, and what it reaches

Parámetros:

• code (obligatorio) — C1 conflict · C2 work · C3 deprivation · C4 exposure.
• scenario — The attribution scenario. The default is the published default (S-MAX).
  uno de: S-MAX · S-EVID · S-RES · S-ARMS · S-CONS

GET /api/v1/scenarios

The five attribution scenarios and their parameters

Parámetros: ninguno

GET /api/v1/runs

The published runs; none while figures are withheld

Parámetros: ninguno

GET /api/v1/runs/{id}

One published run and the verdict of each validation gate

Parámetros:

• id (obligatorio) — The run id a figure's citation names.

GET /api/v1/methodology

The versions of the methodology

Parámetros: ninguno

GET /api/v1/sources

The source register: every source, its licence, and the basis it is used on

Parámetros: ninguno

GET /api/v1/search

Find a product, material, conflict, country or channel

Parámetros:

• q (obligatorio) — Two to 64 characters.

GET /api/v1/openapi.json

This API as an OpenAPI 3.1 document, generated from the route table

Parámetros: ninguno