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

---

Identiplante Api v0.1 : Images

Ce service fournit des informations sur les images.

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 associée à l'image
• "masque.genre" : filtre sur le genre de l'observation associée à l'image
• "masque.ns" : filtre sur le nom scientifique de la détermination associée à l'image (Champ : determination). Ex. : "Abies%"
• "masque.nn" : filtre sur l'identifiant du nom scientifique associé à l'image (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 associée à l'image
• "masque.commune" : filtre la liste en fonction d'un masque de recherche portant sur la commune de l'observation associée à l'image
• "masque.departement" : filtre la liste en fonction d'un masque de recherche portant sur le département de l'observation associée à l'image
• "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)

"protocole" : filtre les commentaires selon le protocole de vote

/images

Retourne une liste d'images, les observations associées et les votes. Par défaut, retourne seulement les 100 premières images.

• Type de requête : GET
• Url : http://tela-botanica.org/service:identiplante:0.1/Images?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"
  • "entete.precedent" : "http://localhost/del/services/0.1/projets/del/images?navigation.depart=10&navigation.limite=10",
  • "entete.suivant" : "http://localhost/del/services/0.1/projets/del/images?navigation.depart=30&navigation.limite=10"
• },
• "resultats": [
  • {
    • "id_image": "7511",
    • "date": "2011-10-28",
    • "binaire.href": "http://www.tela-botanica.org/appli:cel-img:000012001L",
    • "hauteur": "1536",
    • "largeur": "2048",
    • "votes": [
      • {
        • "id_protocole": "0",
        • "valeur": "4",
        • "auteur.id": "250",
        • "date": "2011-12-01"
      • },
      • {
        • "id_protocole": "1",
        • "valeur": "2",
        • "auteur.id": "20",
        • "date": "2011-12-01"
      • }
    • ],
    • "observation": {
      • {
      • "id_observation": "1250",
      • "date_observation": "2007-06-20 00:00:00",
      • "date_transmission": "2007-06-20 00:00:00",
      • "determination.famille": "Abiacée",
      • "determination.ns": "Abies alba Mill.",
      • "determination.nn": "6259",
      • "determination.nt": "10548",
      • "id_zone_geo": "34163",
      • "zone_geo": "Maville",
      • "lieudit": "Sous bois de la huchette",
      • "station": "Bord de chemin sous l'arbre gris",
      • "milieu": "prairie",
      • "auteur.id": "1",
      • "auteur.nom": "Botanica",
      • "auteur.prenom": "Tela"
      • }
    • }
  • }
• ]

}

/images/#id

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

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

Défaut (=defaut) : JSON.
{

• "id_image": "4512",
• "date": "2011-10-28",
• "binaire.href": "http://www.tela-botanica.org/appli:cel-img:000012001L",
• "hauteur": "1536",
• "largeur": "2048",
• "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"
  • }
• ],
• "observation": {
  • "id_observation": "1250",
  • "date_observation": "2007-06-20 00:00:00",
  • "date_transmission": "2007-06-20 00:00:00",
  • "determination.famille": "Abiacée",
  • "determination.ns": "Abies alba Mill.",
  • "determination.nn": "6259",
  • "determination.nt": "10548",
  • "id_zone_geo": "34163",
  • "zone_geo": "Maville",
  • "lieudit": "Sous bois de la huchette",
  • "station": "Bord de chemin sous l'arbre gris",
  • "milieu": "prairie",
  • "auteur.id": "1",
  • "auteur.nom": "Botanica",
  • "auteur.prenom": "Tela"
• }

}

/images/#id/votes

Retourne toutes les votes sur l'image recherchée.

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

Défaut (=defaut) : JSON.
{

• "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"
  • }
• ]
• }

}

/images/#id/votes + PUT

Permet de voter sur l'image recherchée.

• Type de requête : POST
• Url : http://tela-botanica.org/service:identiplante:0.1/Images/4512/votes
• POST : valeur=3&protocole=15&utilisateur=3
• Format retour :

Défaut (=defaut) : JSON.
{

• "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"
  • }
• ]
• }

}

---