Aller au contenu

Vue d'ensemble du jeu de données

GET
/v1/stats
curl --request GET \
--url https://api-equides.org/v1/stats

Effectifs globaux, sans filtre. Pour ventiler une sélection, voir /v1/stats/repartition.

Effectifs globaux.

Media typeapplication/json
object
annee_naissance_max
integer | null
annee_naissance_min
integer | null
avec_filiation

Équidés dont au moins un parent est renseigné.

integer
avec_performances
integer
avertissement

Rappel du sens de « sans performances », que le seul effectif induirait en erreur.

string
nombre_de_disciplines
integer
nombre_de_races
integer
nombre_de_robes
integer
par_sexe
Array<object>

Une modalité et son effectif dans la sélection.

object
nombre
required
integer
valeur
required
string
sans_filiation
integer
sans_performances
integer
total
integer
Examplegenerated
{
"annee_naissance_max": 1,
"annee_naissance_min": 1,
"avec_filiation": 1,
"avec_performances": 1,
"avertissement": "example",
"nombre_de_disciplines": 1,
"nombre_de_races": 1,
"nombre_de_robes": 1,
"par_sexe": [
{
"nombre": 1,
"valeur": "example"
}
],
"sans_filiation": 1,
"sans_performances": 1,
"total": 1
}

Contenu inchangé depuis l’ETag fourni en If-None-Match. Aucun corps, et rien n’est recalculé côté service.

Quota de débit dépassé pour l’adresse appelante. Retry-After indique le délai.

Media typeapplication/problem+json

Corps d’erreur conforme à la RFC 9457 (« Problem Details for HTTP APIs »), servi en application/problem+json. Les champs parametre et indice sont des extensions, que la RFC autorise.

object
detail
required

Explication propre à cette occurrence.

string
documentation
string
indice

Extension : piste de correction — valeurs admises, référentiel à consulter, ou paramètre le plus proche en cas de faute de frappe.

string
parametre

Extension : paramètre fautif, quand l’erreur en désigne un.

string
status
required
integer
title
required

Résumé lisible, stable pour un type donné.

string
type
required

URI du type de problème, relative — le client la résout contre l’URI de la requête. Elle pointe vers la section correspondante de la documentation.

string
Example
{
"detail": "paramètre inconnu `rase`",
"documentation": "https://docs.api-equides.org",
"indice": "vouliez-vous dire `race` ?",
"parametre": "rase",
"status": 400,
"title": "Paramètre invalide",
"type": "/#erreur-parametre-invalide"
}

Capacité de traitement simultané atteinte, délai maximal dépassé, ou données non chargées. Retry-After indique le délai.

Media typeapplication/problem+json

Corps d’erreur conforme à la RFC 9457 (« Problem Details for HTTP APIs »), servi en application/problem+json. Les champs parametre et indice sont des extensions, que la RFC autorise.

object
detail
required

Explication propre à cette occurrence.

string
documentation
string
indice

Extension : piste de correction — valeurs admises, référentiel à consulter, ou paramètre le plus proche en cas de faute de frappe.

string
parametre

Extension : paramètre fautif, quand l’erreur en désigne un.

string
status
required
integer
title
required

Résumé lisible, stable pour un type donné.

string
type
required

URI du type de problème, relative — le client la résout contre l’URI de la requête. Elle pointe vers la section correspondante de la documentation.

string
Example
{
"detail": "paramètre inconnu `rase`",
"documentation": "https://docs.api-equides.org",
"indice": "vouliez-vous dire `race` ?",
"parametre": "rase",
"status": 400,
"title": "Paramètre invalide",
"type": "/#erreur-parametre-invalide"
}