Retour : page principale > sommaire eFlore v5 > Identiplante > Web Services

---

Identiplante Api v0.1 : Observations

Ce service fournit des informations sur les observations.

Descriptions des paramètres de requête du service

"masque" : filtre la liste en fonction d'un masque de recherche portant sur tous les champs Ex. : "%Abies%"

• "masque.famille" : filtre sur la famille de l'observation
• "masque.genre" : filtre sur le genre de l'observation
• "masque.espece" : filtre sur l'espece de l'observation
• "masque.ns" : filtre sur le nom scientifique de la détermination (Champ : determination). Ex. : "%Abies%"
• "masque.nn" : filtre sur l'identifiant du nom scientifique (Champ : determination.nom_sci.code). Possibilité d'en indiquer plusieurs séparés par des virgules. Ex. : 7128
• "masque.auteur" : filtre sur le nom ou l'identifiant du photographe.
• "masque.date" : filtre sur la date d'observation.
• "masque.commune" : filtre la liste en fonction d'un masque de recherche portant sur la commune
• "masque.departement" : filtre la liste en fonction d'un masque de recherche portant sur le département
• "masque.tag" : filtre la liste en fonction d'un masque de recherche portant sur les mots clés associés (éventuellement séparés par des virgules)

/observations

Retourne une liste d'observations, les images associées et les votes. Les images contiennent elles aussi les votes associés aux protocoles. Par défaut, retourne seulement les 100 premières observations.
(A voir si l'on retourne aussi les commentaires sur les déterminations, car ils ne sont pas affiché dans les écran de recherche, il y a juste le nombre)

• Type de requête : GET
• Url : http://tela-botanica.org/service:identiplante:0.1/Observations?masque.auteur=auteur%&navigation.depart="10"&navigation.limite="10"
• Paramètres de requête disponibles : masque, navigation.depart et navigation.limite.
• Format retour :

Défaut (=defaut) : JSON.
{

• "entete": {
  • "masque": "",
  • "depart": "0",
  • "limite": "10",
  • "total": "10"
• },
• "resultats": [
  • {
    • "id_observation": "128544",
    • "date_observation": "2007-06-20 00:00:00",
    • "date_transmission": "2007-06-20 00:00:00",
    • "determination.famille": "Abiacées",
    • "determination.ns": "Abies alba Mill.",
    • "determination.nn": "6259",
    • "determination.nt": "10548",
    • "observateur": "p.nom@email.fr",
    • "id_zone_geo": "34163",
    • "zone_geo": "Maville",
    • "lieudit": "Sous bois de la huchette",
    • "station": "Bord de chemin sous l'arbre gris",
    • "milieu": "prairie",
    • "auteur.nom": "Botanica",
    • "auteur.prenom": "Tela",
    • "auteur.id": "1",
    • "images": {
      • "id_image": "6711",
      • "date": "2011-10-28",
      • "binaire.href": "http://www.tela-botanica.org/appli:cel-img:000012001L",
      • "hauteur": "1536",
      • "largeur": "2048"
    • },
    • "propositions": [
      • {
        • "id_proposition": "1",
        • "nom_sel": "Abies excelsior",
        • "nom_sel_nn": "3250",
        • "nom_sel_nt": "2510",
        • "auteur.id": "250",
        • "date": "2011-12-01",
        • "nb_commentaires": "10",
        • "votes": [
          • {
            • "id_vote": "18",
            • "vote": "0",
            • "auteur.id": "1588",
            • "date": "2011-12-01"
          • },
          • {
            • "id_vote": "25",
            • "vote": "1",
            • "auteur.id": "1998",
            • "date": "2011-12-01"
          • }
        • ]
      • }
    • ]
  • }
• ]

}

/observations/#id

Retourne toutes les informations sur l'observation recherchée, ainsi que ses images et votes associés et les commentaires

• Type de requête : GET
• Url : http://tela-botanica.org/service:identiplante:0.1/Observations/1250
• Format retour :

Défaut (=defaut) : JSON.
{

• "id_observation": "1250",
• "date_observation": "2007-06-20 00:00:00",
• "date_transmission": "2007-06-20 00:00:00",
• "determination.famille": "Abiacées",
• "determination.ns": "Abies alba Mill.",
• "determination.nn": "6259",
• "determination.nt": "10548",
• "observateur": "p.nom@email.fr",
• "id_zone_geo": "34163",
• "zone_geo": "Maville",
• "lieudit": "Sous bois de la huchette",
• "station": "Bord de chemin sous l'arbre gris",
• "milieu": "prairie",
• "auteur.nom": "Botanica",
• "auteur.prenom": "Tela",
• "auteur.id": "1",
• "images": {
  • "id_image": "6711",
  • "date": "2011-10-28",
  • "mime": "image/jpeg",
  • "binaire.href": "http://www.tela-botanica.org/appli:cel-img:000012001L",
  • "hauteur": "1536",
  • "largeur": "2048",
  • "mots_cles_texte": "fleur,fruit",
  • "votes": [
    • {
      • "id_protocole": "0",
      • "vote": "4",
      • "auteur.id": "250",
      • "date": "2011-12-01"
    • },
    • {
      • "id_protocole": "1",
      • "vote": "2",
      • "auteur.id": "20",
      • "date": "2011-12-01"
    • }
  • ]
• },
• "propositions": [
  • {
    • "id_proposition": "1",
    • "nom_sel": "Abies excelsior",
    • "nom_sel_nn": "3250",
    • "nom_sel_nt": "2510",
    • "auteur.id": "250",
    • "date": "2011-12-01",
    • "commentaires": [
      • {
        • "id_commentaire": 1,
        • "texte": "ah non",
        • "auteur.id": "125",
        • "auteur.nom": "Nom",
        • "auteur.prenom": "Prénom",
        • "commentaires": [ ]
      • }
    • ],
    • "votes": [
      • {
        • "id_vote": "188",
        • "vote": "0",
        • "auteur.id": "1588",
        • "date": "2011-12-01"
      • },
      • {
        • "id_vote": "55",
        • "vote": "1",
        • "auteur.id": "1998",
        • "date": "2011-12-01"
      • }
    • ]
  • },
  • {
    • "id_proposition": "1",
    • "nom_sel": "Abies alba",
    • "nom_sel_nn": "3250",
    • "nom_sel_nt": "2510",
    • "auteur.id": "250",
    • "date": "2011-12-01",
    • "commentaires": [ ]
  • }
• ],
• "nb_commentaires": "10",
• "commentaires": [
  • {
    • "id_commentaire": "1",
    • "texte": "Quelle belle photo !",
    • "auteur.id": "125",
    • "auteur.nom": "Nom",
    • "auteur.prenom": "Prénom",
    • "commentaires": [
      • {
        • "id_commentaire": "1",
        • "texte": "Oui je confirme !",
        • "auteur.id": "25",
        • "auteur.nom": "Nom",
        • "auteur.prenom": "Prénom",
        • "commentaires": [ ]
      • }
    • ]
  • }
• ]

}