Retour : page principale > sommaire eFlore v5 > eFlore API v0.1

eFlore Api v0.1 : Taxons


Ce service fournit des informations sur les taxons, c'est à dire les noms scientifiques retenus par le projet.

Descriptions des paramètres de requête du service
La liste des paramètres est identique à celle de la ressources Noms à l'exception du sous-masque masque.nn remplacé par masque.nt et de distinct qui n'est pas utilisable.
  • masque : filtre la liste en fonction d'un masque de recherche portant sur le nom scientifique.
    • masque.nt : filtre sur l'identifiant du taxon (numéro taxonomique au sens de la BDNFF) pour les projets en possédant. Possibilité d'en indiquer plusieurs séparés par des virgules. Ex. : 181,7547

/taxons
Retourne une liste de noms scientifiques retenus (=taxons) et leur identifiant. Par défaut, retourne seulement les 100 premiers noms scientifiques retenus.
Défaut (=defaut) : JSON.

 }

Open Search Suggest (=oss) : JSON
[
  • "masque de recherche",
  • [
    • "nom scientifique",
    • "nom scientifique",
    • "nom scientifique"
  • ]
]


/taxons/#id
Retourne toutes les informations sur le taxon recherché
  • Type de requête : GET
  • URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/taxons/#id
  • Paramètres du chemin :
    • "#id" : identifiant d'un nom scientifique appartement au groupe nominal d'un taxon. Si l'identifiant est celui d'un synonyme, les informations du taxon correspondant seront retournées. Il est possible d'utiliser la clé secondaire "num_taxonomique" comme identifiant pour les projets utilisant un identifiant différent du nom retenu pour désigner le taxon. Dans ce cas là, #id aura la forme : nt:#id.
  • Paramètres de requête disponibles : ns.format et ns.structure.

/taxons/#id/#champ+#champ
Retourne l'information présent dans les champs indiqués pour le taxon recherché
  • Type de requête : GET
  • URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id/#champs
  • Paramètres du chemin :
    • "#id" : identifiant du nom dont on veut les informations détaillées.
    • "#champs" : nom du champ dont on veut l'information. Plusieurs noms peuvent être indiqué en les séparant par le caractère "+".
  • Paramètres de requête disponibles : ns.format et ns.structure.
  • Format retour :
Défaut (=defaut) : JSON. Pour les descriptions de chaque champ voir le Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
Pour l'url http://tela-botanica.org/service:eflore:0.1/bdnff/5.00/taxons/1/rang.code+tax_sup.id+rang nous aurons :
{
  • "id" : "1",
  • "tax_sup.id" : "2",
  • "rang.code" : "bdnt.rangTaxo:290"
  • "rang" : "espèce"
}
Pour l'url http://tela-botanica.org/service:eflore:0.1/bdnff/5.00/taxons/1/rang.*+tax_sup nous aurons :
{
 }

/taxons/#id/relations
Retourne la liste des relations du taxon indiqué par son #id.
  • Type de requête : GET
  • Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/taxons/#id/relations
  • Paramètres du chemin :
    • "#id" : identifiant d'un nom de taxon dont on cherche les relations (synonymie, relations avec d'autres référentiels...). Il est possible d'utiliser la clé secondaire "num_taxonomique" comme identifiant pour les projets utilisant un identifiant différent du nom retenu pour désigner le taxon. Dans ce cas là, #id aura la forme : nt:#id.
  • Paramètres de requête disponibles : ns.format et ns.structure.

/taxons/#id/relations/inferieurs
Fournit l'ensemble des noms retenus du rang immédiatement inférieur à celui du nom passé en paramètre. Si le nom passé en paramètre est une synonyme, nous chercherons son nom retenu. Si le nom indiqué n'a aucun nom de rang inférieur, "NULL" sera retourné.
  • Type de requête : GET
  • URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/taxons/#id/inferieurs
  • Paramètres du chemin :
    • "#id" : identifiant d'un nom appartement au groupe nominal d'un taxon. Si l'identifiant est celui d'un synonyme, les informations du taxon correspondant seront retournées. Il est possible d'utiliser la clé secondaire "num_taxonomique" comme identifiant pour les projets utilisant un identifiant différent du nom retenu pour désigner le taxon. Dans ce cas là, #id aura la forme : nt:#id.
  • Paramètres de requête disponibles : ns.format et ns.structure.
  • Format retour :
Défaut (=defaut) : tableau d'objets JSON. Le champ "taxon_inferieur_nbre" indiquera le nombre de noms du rang inférieur.
{
  • "Identifiant du nom recherché" :
  • {
    • "id_nom" : {
      • "nom_sci" : "nom scientifique",
      • "retenu" : true,
      • "taxon_inferieur_nbre" : 12
    • },
    • "id_nom" : {
      • "nom_sci" : "nom scientifique",
      • "retenu" : true,
      • "taxon_inferieur_nbre" : 4
    • }
  • }
}


/taxons/#id/relations/superieurs
Fournit l'ensemble des noms retenus de rang supérieur à celui du nom passé en paramètre. Si le nom passé en paramètre est un synonyme, nous chercherons son nom retenu. Si le nom indiqué n'a aucun nom de rang supérieur, "NULL" sera retourné.
  • Type de requête : GET
  • URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/taxons/#id/superieurs
  • Paramètres du chemin :
    • "#id" : identifiant d'un nom appartement au groupe nominal d'un taxon. Si l'identifiant est celui d'un synonyme, les informations du taxon correspondant seront retournées. Il est possible d'utiliser la clé secondaire "num_taxonomique" comme identifiant pour les projets utilisant un identifiant différent du nom retenu pour désigner le taxon. Dans ce cas là, #id aura la forme : nt:#id.
  • Paramètres de requête disponibles : ns.format et ns.structure.
  • Format retour :
Défaut (=defaut) : tableau d'objets JSON. Les noms sont classés du nom de rang immédiatement supérieur vers le plus éloigné. Si on a un nom d'espèce, nous aurons en premier le genre, puis la famille, l'ordre... Les codes et noms des rangs sont ceux utilisés dans le Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
{
 }


/taxons/#id/relations/hierarchie
Fournit l'ensemble des noms de rang inférieur à celui du nom passé en paramètre, quelque soit la distance avec celui-ci. Si le nom passé en paramètre est une synonyme, nous chercherons son nom retenu. Si le nom indiqué n'a aucun nom de rang inférieur, "NULL" sera retourné.
  • Type de requête : GET
  • URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/taxons/#id/hierarchie
  • Paramètres du chemin :
    • "#id" : identifiant d'un nom appartement au groupe nominal d'un taxon. Si l'identifiant est celui d'un synonyme, les informations du taxon correspondant seront retournées. Il est possible d'utiliser la clé secondaire "num_taxonomique" comme identifiant pour les projets utilisant un identifiant différent du nom retenu pour désigner le taxon. Dans ce cas là, #id aura la forme : nt:#id.
  • Paramètres de requête disponibles : ns.format et ns.structure.
  • Format retour :
Défaut (=defaut) : tableau d'objets JSON. Le champ "taxon_inferieur_nbre" indiquera le nombre de noms du rang inférieur.
{
  • "Identifiant du nom recherché" :
  • {
    • "id_nom" : {
      • "nom_sci" : "nom scientifique",
      • "retenu" : true,
    • },
    • "id_nom" : {
      • "nom_sci" : "nom scientifique",
      • "retenu" : true,
    • }
  • }
}


Statistiques


/taxons/stats/initiales
Fournit un tableau indiquant pour un rang donné l'ensemble des premières lettres des noms des taxons de ce rang et le nombre de taxons correspondant.
Défaut (=defaut) : tableau associatif JSON. La clé représente une lettre, la valeur le nombre de taxons débutant par cette lettre.
{
  • "famille" :
  • {
    • "A" : 10,
    • "B" : 8,
    • "C" : 14,...
  • }
}


/taxons/stats/rangs
Fournit un tableau indiquant pour un rang donné le nombre de taxons correspondant.
Défaut (=defaut) : tableau associatif JSON. Indiquer les rangs du règnes vers les rangs inférieurs.
{
  • "code numérique du rang" : {
    • "rang" : "Famille",
    • "nombre" : 145
  • },
  • "code numérique du rang" : {
    • "rang" : "Genre",
    • "nombre" : 255
  • },...
}


/taxons/stats/annees
Fournit un tableau indiquant pour une année donnée le nombre de taxons publiés à cette date.
Défaut (=defaut) : tableau associatif JSON. Indiquer les années des plus anciennes aux plus récentes.
{
  • 1999 : 145,
  • 2000 : 145,...
}