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

---

eFlore Api v0.1 : Personnes

Ce service fournit des informations sur les personnes vivantes ou décédées.
Pour les personnes vivantes, l'utilisation de champs liées au standard vCARD est conseillé.
Pour les informations historiques sur les personnes, l'utilisation de l'ontologie sur les personnes du TDWG est conseillée.
Enfin, le standard FOAF est conseillée pour représenter les relations entre personnes.
Ce service pourra être restreint ou sécurisé en fonction pour éviter la collecte de courriel à des fins de spam.

Descriptions des paramètres de requête du service

Ces paramètres sont optionnels et sont passés après le signe "?" dans l'URL.

• "masque" : filtre la liste en fonction d'un masque de recherche portant sur le nom. Ex. : "Nom"
  • "masque.nom" : filtre sur le nom. Ex. : "NOM"
  • "masque.prenom" : filtre sur le prénom. Ex. : "Prénom"
  • "masque.email" : filtre sur l'adresse mail. Ex. : "p.nom@email.fr"
  • "masque.date_naissance" : filtre sur la date de naissance. Ex. : "0000-00-00"
  • "masque.fonction" : filtre sur la fonction de la personne. Ex. : "Enseignant"
  • "masque.specialite" : filtre sur les spécialités de la personne. Ex. : "Bryophytes", "Plantes de la région Languedoc-Roussillon"
  • "masque.czg" : filtre la liste en fonction d'un masque de recherche portant sur un code de zone géographique. Ce code est composé du code du projet de référentiel géographique (INSEE-C, ISO-3166-1...) et de l'identifiant de la zone géographique. Ex. : "INSEE-D.30".
• "retour.format" (=max|min): indique le format de retour. max (par défaut) : un objet JSON contenant toutes les informations (même les intitulés des données liées). min : pour obtenir seulement les infos de la table (les intitulés des infos liées doivent être obtenue via les href).
• "navigation.depart" : indique la ligne de résultat où débuter l'affichage des résultats. Par défaut vaut 0.
• "navigation.limite" : indique le nombre de lignes de résultats à retourner. Par défaut vaut 100.

/personnes

Retourne une liste de personnes et leur identifiant dans le projet. Par défaut, retourne seulement les 100 premiers noms.

• Type de requête : GET
• Url : http://tela-botanica.org/service:eflore:0.1/#projet/#version/personnes?masque=nom%&navigation.depart="10"&navigation.limite="10"
• Paramètres de requête disponibles : masque (et tous ses sous concepts : masque.nom, masque.prenom...), navigation.depart et navigation.limite.
• Format retour :

Défaut (=defaut) : JSON.
{

• "entete" : {
  • "masque" : "nom",
  • "depart" : "10",
  • "limite" : "10",
  • "total" : "8",
  • "href.precedent" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/noms?masque=nom%&navigation.depart=0&navigation.limite=10" # URL pour obtenir les résultats précédents
  • # Pas d'URL href.suivant pour obtenir les résultats suivants car seulement 8 résultats
• },
• "resultats" : {
  • "6711" : { # Identifiant de la personne
    • "nom" : "Nom",
    • "prenom" : "Prenom",
    • "courriel" : "p.nom@email.fr",
    • "href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/personnes/6711"
  • },
  • "7312" : { # Identifiant de la personne
    • "nom" : "Nom",
    • "prenom" : "Prenom",
    • "courriel" : "p.nom@email.fr",
    • "href" : "http://tela-botanica.org/service:eflore:0.1/#projet/#version/personnes/7312"
    • },...
• }

}

/personnes/#id

Retourne toutes les informations sur la personne recherchée

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

Défaut (=defaut) : JSON.
{

• "id" : "1",
• "nom" : "NOM",
• "prenom" : "Prénom",
• "courriel" : "p.nom@email.fr",
• "fonction" : "Pr.",
• "specialite" : "Forêts canadiennes",
• "departement" : "ISO-3166-2.FR-34"
• "adresse" : "34000 MONTPELLIER",
• "region" : "ISO-3166-2.FR-K",
• "pays" : "ISO-3166-1.FR",
• et les champs spécifiques aux projets

}

---