eFlore : ApiIdentiplante01Images

Joindre / Insérer un fichier

** Retour : ** [[PagePrincipale page principale ]] > [[ProjetEfloreVersion5 sommaire eFlore v5]] > [[IdentiPlante Identiplante]] > [[ApiIdentiplante01 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"
        }
    ]
    }
}##

Thème

Télécharger le fichier

Déjà membre

Nouveau membre

Apparence de la page ApiIdentiplante01Images

Image de fond

Paramètres avancés