PdM — peinedemort.org API

Télécharger la description au format OpenApi YAML (Swagger)

Version 1.0.0

Données sous Licence CC BY 4.0. Autorisation de réutilisation des données à condition d'en mentionner l'origine.

Licence des données

Licence Creative Commons Attribution 4.0 International : https://creativecommons.org/licenses/by/4.0/deed.fr

Description

Récupérer automatiquement des données structurées en provenance de peinedemort.org

Contact

Nom: Sophie Fotiadi
URL: https://www.peinedemort.org/site/contact

Format des réponses

Par défaut, le format des réponses est déterminé par négociation, il dépend des en-têtes de la requête HTTP. Ainsi, un navigateur web qui enverrait l'en-tête habituel Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 recevrait une réponse en XML. Il est possible d'imposer le format JSON en ajoutant un paramètre à l'URL : _format=json, par exemple /api/zones/pays?id=FRA&_format=json.

Liste des chemins

Tous les chemins suivant doivent être préfixés par /api.

/traites GET Liste des traités
/traites/ratifications GET Signatures, ratifications et adhésions d'un traité donné.
/zones/pays GET Liste de pays (tous ou un seul).
/zones/etats-americains GET Liste des États des États-Unis d'Amérique.

Détail des actions

/traites

GET /traites

Titre

Liste des traités

Description

Liste de traités concernant la peine de mort.

URL

GET /api/traites

Réponses

Code HTTP	Description	Schema
200	Liste de traités	[ → Traite ]
default	Erreur	→ Error

Essayer cette action Essayer cette action (JSON)

/traites/ratifications

GET /traites/ratifications

Titre

Signatures, ratifications et adhésions d'un traité donné.

Description

Liste de tous les pays ayant signé, ratifié ou adhéré à ce traité.

Par exemple pour le Deuxième Protocole facultatif au PIDCP visant à abolir la peine de mort.

URL

GET /api/traites/ratifications

Paramètres

Nom	Description	Lieu	Requis ?	Type, format
id	Identifiant unique du traité (voir /traites)	query	Oui	string

Réponses

Code HTTP	Description	Schema
200	Liste de pays avec les infos de ratification, etc.	→ Ratifications
default	Erreur	→ Error

/zones/pays

GET /zones/pays

Titre

Liste de pays (tous ou un seul).

Description

Liste de tous les pays, avec pour chacun le statut de la peine de mort, ou information pour un seul pays si le paramètre "id" est donné.

URL

GET /api/zones/pays

Paramètres

Nom	Description	Lieu	Requis ?	Type, format
id	Code ISO sur 3 lettres du pays	query	Non	string

Réponses

Code HTTP	Description	Schema
200	Liste de pays avec le statut de la peine de mort.	[ → Pays ]
default	Erreur	→ Error

/zones/etats-americains

GET /zones/etats-americains

Titre

Liste des États des États-Unis d'Amérique.

Description

Liste de tous les États des États-Unis d'Amérique, avec pour chacun le statut de la peine de mort.

URL

GET /api/zones/etats-americains

Réponses

Code HTTP	Description	Schema
200	Liste d'États américains avec le statut de la peine de mort.	[ → Etat ]
default	Erreur	→ Error

Essayer cette action Essayer cette action (JSON)

Modèles de données

Traite

titre	string
description	string
contenu	string
date_publication	string, date
date_entree_vigueur	string, date
url_origine	string
id	string
carte_url	string
api_urls	[ string ]

Ratifications

traite	string Nom du traité ratifié
id	string Identifiant du traité pour peinedemort.org.
ratifications	[ → PaysRatification ] Liste des pays ayant au moins amorcé la ratification ce traité (signé, ratifié ou adhéré), avec les informations liées.

PaysRatification

pays	→ Pays
entree_vigueur_date	string, date
denonciation_date	string, date
reserve	string Réserve formulée lors de l'adhésion ou de la ratification.
signature_date	string, date
ratification_date	string, date éventuelle ratification post-signature, pour devenir partie au traité.
adhesion_date	string, date éventuelle adhésion directe (ratification sans signature préalable).

Pays

nom	string
code_iso	string code ISO 3166-1 alpha-3, formé de 3 lettres latines majuscules
date_abolition	string, date
date_abolition_droit_commun	string, date
date_derniere_execution	string, date L'absence de ce champ indique généralement que l'information est absente dans la base de données, même si des exécutions ont eu lieu.
peinedemort	string Le statut légal de la peine de mort : Abolitionniste, Abolitionniste en pratique, Abolitionniste pour les crimes de droit commun, Pratique la peine de mort.
url	string URL de ce pays sur le site peinedemort.org

Etat

nom	string
code_iso	string code ISO 3166-1, formé de "US-" suivi de 2 lettres latines majuscules
date_abolition	string, date
date_abolition_droit_commun	string, date
date_derniere_execution	string, date Une valeur vide indique généralement que l'information est absente dans la base de données.
peinedemort	string Le statut légal de la peine de mort : Abolitionniste, Abolitionniste en pratique, Abolitionniste pour les crimes de droit commun, Pratique la peine de mort.
url	string URL de cet État américain sur le site peinedemort.org
executions	integer nombre d'exécutions depuis 1977
reprise	string, date date éventuelle de la reprise d'exécutions après 1977

Error

code	integer, int32
message	string
fields	string