eFlore Api v0.1 : Noms

Descriptions des paramètres de requête du service

• masque : filtre la liste en fonction d'un masque de recherche portant sur le nom scientifique complet. Ex. : "Ace mons"
• masque.sg : filtre sur le nom supra-générique. Ex. : "adiantaceae"
• masque.gen : filtre sur le nom de genre. Ex. : "abies"
• masque.sp : filtre sur l'épithète d'espèce. Ex. : "maritimum"
• masque.ssp : filtre sur l'épithète infra-spécifique. Ex. : "cuprina"
• masque.au : filtre sur l'intitulé auteur du nom. Ex. : "Tausch"
• masque.an : filtre sur l'année de publication du nom. Ex. : "1923"
• masque.bib : filtre sur la référence bibliographique de la publication d'origine du nom (sans l'année). Ex. : "Linnaea, 21"
• masque.ad : filtre sur le nomen addendum (commentaires nomenclaturaux et taxonomiques). Ex. : "nom. illeg."
• masque.nn : filtre sur l'identifiant du nom. Possibilité d'en indiquer plusieurs séparés par des virgules. Ex. : 7128,7547
• masque.nt : filtre sur l'identifiant du taxon. Possibilité d'en indiquer plusieurs séparés par des virgules.
• masque.rg : filtre sur le rang (code numérique indiquant le rang du nom) des noms à rechercher. Les codes et noms des rangs sont ceux utilisés dans le Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.fam : filtre sur la famille Ex. : "Fabaceae"
• masque.prga: filtre sur le statut de présence en France. cf. Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.prco: filtre sur le statut de présence en Corse. cf. Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.sto: filtre sur le statut d'origine. cf. Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.sti: filtre sur le statut d'introduction. cf. Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.stc: filtre sur le statut de culture. cf. Manuel Technique Pour l'élaboration des BDNT Flore et Fonge
• masque.and et masque.anf : filtre sur un intervalle de date Ex. "1925" . and = année de début de l'intervalle et anf = année de fin de l'intervalle
• distinct (=0|1) : indique que l'on veut les noms distincts (par défaut tous les noms, même semblable, sont renvoyés). Ne peut être utilisé qu'avec le format oss!
• ns : paramètres concernant les noms scientifiques.
• ns.format (=txt|htm) : indique le type de formatage du nom scientifique, en texte (=txt) ou avec des balises xhtml (=html). Par défaut, cela vaut "txt".
• ns.structure (='',au,an,bib,ad,gen,fam,sp,ssp,auss,bibss) : permet de choisir les informations sur le nom renvoyé. Les codes suivant séparés par des virgules indiqueront les informations complémentaires du nom à renvoyer : ''

• retour.tri (=retenu|retenu,ASC|retenu,DESC) : paramètres permettant de trier l'ensemble de résultats (pas uniquement les résultats de la page courante). Pour l'instant seul le tri sur les noms retenus est actif. Les noms retenu peuvent soit apparaitre en début de liste (retenu|retenu,ASC) ou en fin de liste (retenu,DESC).
• N.B. : les masques autorisent une recherche sur plusieurs valeurs pour un même champs

/noms

• Type de requête : GET
• Url : api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms?masque=Acer%20mons&distinct=0&format=txt&structure=au,an,inau,bib
• Paramètres de requête disponibles : masque (et tous ses sous concepts : masque.sg, masque.gen...), recherche, rang, distinct, retour.format, ns.format, ns.structure, navigation.depart et navigation.limite.
• Format retour :

• "entete" : {
  • "masque" : "Acer",
  • "depart" : "10",
  • "limite" : "10",
  • "total" : "28",
  • "href.precedent" : "api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms?masque=Acer&format=txt&structure=au,an,inau,bib&navigation.depart=0&navigation.limite=10" # URL pour obtenir les résultats précédents
  • "href.suivant" : "api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms?masque=Acer&format=txt&structure=au,an,inau,bib&navigation.depart=20&navigation.limite=10" # URL pour obtenir les résultats suivants
• },
• "resultats" : {
  • "6711" : { # Identifiant du nom
    • "nom_sci" : "nom scientifique",
    • "retenu" : true,
    • "href" : "api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms/6711"
  • },
  • "7312" : { # Identifiant du nom
    • "nom_sci" : "nom scientifique",
    • "retenu" : false,
    • "href" : "api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms/7312"
    • },...
• }

• "masque de recherche",
• [
  • "nom scientifique",
  • "nom scientifique",
  • "nom scientifique"
• ]

/noms/#id

• Type de requête : GET
• URI : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id
• Paramètres du chemin :
  • "#id" : identifiant du nom dont on veut les informations détaillées.
• Paramètres de requête disponibles : ns.format et ns.structure.
• Format retour :

{
  "id" : "1",
  "nom_retenu.id" : "71574",
  "nom_retenu.href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/71574"
  "rang" : "espèce",
  "rang.code" : "290",
  "rang.href" : "http://tela-botanica.org/service:eflore:0.1/bdnt/ontologie/rangTaxo:290",
  "nom_sci" : "Abacosa dumetorum", # Ce champs est formaté suivant les paramètres de requête (ns.format et ns.structure) passés au service
  "genre" : "Abacosa",
  "epithete_sp" : "dumetorum",
  "auteur" : "(L.) Alef.",
  "annee" : "1861",
  "biblio_origine" : "Bonplandia, 9 : 104",
  "basionyme.id" : "71574",
  "basionyme.href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/71574",
  "proparte" : [
    {"id" : "26",
     "nom_sci" : "Le nom du taxon pour lequel ce taxon correspond en partie (pro parte).",
     "href" : " http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/26"},#Si ce taxon a été //fusionné//, le tableau ne contiendra qu'une seule entrée.
    {"id" : "27",
     "nom_sci" : "Le nom du taxon pour lequel ce taxon correspond en partie (pro parte).",
     "href" : " http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/27"},... # Si ce taxon a été //divisé//, le tableau contiendra plusieurs entrées.
    ],
  et les champs spécifiques aux projets
}

/noms/#id/relations

• Type de requête : GET
• Url : api.tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id/relations
• Paramètres du chemin :
  • "#id" : identifiant du nom dont on cherche les synonymes.
• Paramètres de requête disponibles : ns.format et ns.structure.

• "entete": {
  • "id ": "238"
  • "nom_sci" : "Aceras densiflora"
  • "href" : "api.tela-botanica.org/service:eflore:0.1/bdnff/noms/238"
• }
• "resultat" : {
  • "flores" : {
    • "flore_coste" : {
      • "id" : "3586"
      • "href" : "api.tela-botanica.org/service:eflore:0.1/coste/noms/nn_coste:3586"
      • }
    • }
  • }
  • "homonymes" : {
    • "239" {
      • "nom_sci" : "Aceras densiflora"
      • "href" : api.tela-botanica.org/service:eflore:0.1/bdnff/3.00/noms/239
      • "retenu" : "false"
  • }
  • "synonyme" : {
    • "238" : {
      • "nom_sci: "Aceras densiflora"
      • "href" : "api.tela-botanica.org/service:eflore:0.1/bdnff/3.00/noms/238"
      • "retenu" : "false"
    • }
    • "238" : {
      • "nom_sci: "Orchis secundiflora"
      • "href" : "api.tela-botanica.org/service:eflore:0.1/bdnff/3.00/noms/46212"
      • "retenu" : "false"
      • "basionyme.id: "46212"
      • "basionyme: "Orchis secundiflora"
      • "basionyme.href: api.tela-botanica.org/service:eflore:0.1/bdnff/3.00/noms/46212
    • }
  • }
• }

/noms/#id/relations/synonymie

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id/relations/synonymie
• Paramètres du chemin :
  • "#id" : identifiant du nom dont on cherche les synonymes.
• Paramètres de requête disponibles : ns.format, ns.structure, navigation.depart et navigation.limite.

• "entete" : {
  • "id" : "521",# infique l'id du nom pour lequel on affiche la synonymie
  • "depart" : "10",
  • "limite" : "10",
  • "total" : "28",
  • "href.precedent" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/521/relations/synonymie?ns.format=txt&ns.structure=au,an,inau,bib&navigation.depart=0&navigation.limite=10" # URL pour obtenir les résultats précédents
  • "href.suivant" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/521/relations/synonymie?ns.format=txt&ns.structure=au,an,inau,bib&navigation.depart=20&navigation.limite=10" # URL pour obtenir les résultats suivants
• },
• "resultats" : {
  • "6711" : { # Identifiant du nom
    • "nom_sci" : "nom scientifique du nom retenu",
    • "basionyme" : "nom scientifique du basionyme de ce nom retenu",
    • "basionyme.id" : "Identifiant du basionyme. Ex. : 182",
    • "basionyme.href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id_basionyme",
    • "retenu" : true,
    • "href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/6711"
  • },
  • "7312" : { # Identifiant du nom
    • "nom_sci" : "nom scientifique du synonyme",
    • "basionyme" : "nom scientifique du basionyme de ce nom retenu",
    • "basionyme.id" : "Identifiant du basionyme. Ex. : 182",
    • "basionyme.href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id_basionyme",
    • "retenu" : false,
    • "href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/7312"
  • },...
• }

/noms/#id/relations/homonymie

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id/relations
• Paramètres du chemin :
  • "#id" : identifiant du nom dont on cherche les synonymes.
• Paramètres de requête disponibles : nl.format et nl.structure, navigation.depart et navigation.limite.

• "entete": {
  • "id ": "238"
  • "depart" : "10",
  • "limite" : "10",
  • "total" : "28",
  • "href.precedent" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/521/relations/synonymie?ns.format=txt&ns.structure=au,an,inau,bib&navigation.depart=0&navigation.limite=10" # URL pour obtenir les résultats précédents
  • "href.suivant" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/521/relations/synonymie?ns.format=txt&ns.structure=au,an,inau,bib&navigation.depart=20&navigation.limite=10" # URL pour obtenir les résultats suivants
• }
• "resultats" : {
  • "239" : {
    • "nom_sci" : "Aceras densiflora"
    • "href" : http://162.38.234.8/service:eflore:0.1/bdnff/3.00/noms/239
    • "retenu" : "false"
  • }
• }

/noms/#id/relations/flores

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/#id/relations
• Paramètres du chemin :
  • "#id" : identifiant du nom dont on cherche les synonymes.
• Paramètres de requête disponibles : nl.format et nl.structure.

• "entete": {
  • "id": "21"
  • "nom_sc"i: "Abies excelsa"
  • "href": http://tela-botanica.org/service:eflore:0.1/bdnff/noms/21
• }
• "resultats": {
  • "flore_bonnier": {
    • "id": "0"
    • "href" : "http://teal-botanica.org/service:eflore:0.1/#projet/#version/taxons/0"
  • },
  • "flore_coste": {
    • "id": "3335"
    • "href" : "http://teal-botanica.org/service:eflore:0.1/#projet/#version/taxons/3335"
    • "remarque": "DC."
  • },
  • "flore_fournier": {
    • "id": "0098"
    • "href" : "http://teal-botanica.org/service:eflore:0.1/#projet/#version/noms/0098"
    • "cle" : "-1°a-bis"
  • },...
• }

/noms/relations/#projets/#id/#type

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet_courant/#version/noms/relations#projet/#id/#type
• Paramètres du chemin :
  • "#projet" : code du projet dans lequel on connait l'identifiant et dont on cherche les relations dans le projet courant.
  • "#id" : identifiant du nom dont on cherche les synonymes.
  • "#type" : détermine le type de renseignements recherché : synonymie, homonymie ou flores
• Paramètres de requête disponibles : ns.format, ns.structure

• "id": "5146",
• "nom_sci": "Abies excelsa",
• "href": "http://localhost/service:eflore:0.1/coste/noms/5146"

• "flores": {
  • "flore_bdnff": {
    • "id": "21"
  • }
• },
• "homonymes": {
  • "5146": {
    • "nom_sci": "Abies excelsa",
    • "href": "http://localhost/service:eflore:0.1/coste/noms/5146",
    • "retenu": "true"
  • }
• },
• "synonymes": {
  • "5146": {
    • "nom_sci": "Abies excelsa",
    • "href": "http://localhost/service:eflore:0.1/coste/noms/5146",
    • "retenu": "true",
    • "basionyme.id": , "basionyme.href": "http://localhost/service:eflore:0.1/coste/noms/" }, "5147": { "nom_sci": "Abies picea", "href": "http://localhost/service:eflore:0.1/coste/noms/5147", "retenu": "false", "basionyme.id": ,
    • "basionyme.href": "http://localhost/service:eflore:0.1/coste/noms/"
  • }...
• }

Statistiques

/noms/stats/initiales

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/stats/initiales
• Paramètres de requête disponibles : rang.
• Format retour :

• "famille" :
• {
  • "A" : 10,
  • "B" : 8,
  • "C" : 14,...
• }

/noms/stats/rangs

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/stats/rangs
• Paramètres de requête disponibles : rang.
• Format retour :

• "code numérique du rang" : {
  • "rang" : "Famille",
  • "nombre" : 145
• },
• "code numérique du rang" : {
  • "rang" : "Genre",
  • "nombre" : 255
• },...

/noms/stats/annees

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms/stats/annees
• Format retour :

• 1999 : 145,
• 2000 : 145,...

Divers

Nom sans correspondance

Formatage des noms scientifiques

Correspondance champs BDNT / API