eFlore : ApiIdentiplante01Votes

Joindre / Insérer un fichier

** Retour : ** [[PagePrincipale page principale ]] > [[ProjetEfloreVersion5 sommaire eFlore v5]] > [[IdentiPlante Identiplante]] > [[ApiIdentiplante01 Web Services]]
----
====== Identiplante Api v0.1 : Votes ======

Ce service fournit des informations sur les votes.

== /images/#id_image/votes ==
Retourne une liste de votes sur des protocoles pour un identifiant d'image donné
 - Type de requête : GET
 - Url : http://tela-botanica.org/service:identiplante:0.1/images/2555/votes
  - Paramètres de requête disponibles : 
  - navigation.depart et navigation.limite.
  - masque.protocole = l'identifiant du protocole d'après lequel on veut les votes
 - Format retour : 
Défaut (=defaut) : JSON.
##{
    "entete": {
        "masque": " ",
        "depart": "0",
        "limite": "2",
        "total": "2"
    },
    "resultats": [
        {
            "id_protocole": "0",
            "id_vote": "55",
            "vote": "4",
            "id_image": "2555",
            "auteur.id": "250",
            "auteur.nom": "Nom",
            "auteur.prenom": "Prenom",
            "auteur.courriel": "Courriel",
            "date": "2011-12-01"
        },
        {
            "id_protocole": "0",
            "id_vote": "55",
            "vote": "3",
            "id_image": "2555",
            "auteur.id": "250",
            "auteur.prenom": "Prenom",
            "auteur.courriel": "Courriel",
            "date": "2011-12-21"
        }
}##

== /images/#id_image/votes/ + POST ==
Ajout un vote à l'image dont l'identifiant est passé en ressource
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/images/125/votes
 - Paramètres de requête :
  - id_protocole : identifiant du protocole contre lequel on vote
  - vote : valeur du vote (normalement entre 0 et 5)
  - id_auteur : identifiant de l'auteur du vote
  - prenom_auteur : prenom de l'auteur 
  - nom_auteur : nom de l'auteur 
  - courriel_auteur : courriel de l'auteur 
  (si un identifiant est présent, les informations prenom, nom, courriel, peuvent être prises de la base de données utilisateur)
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

== /images/#id_image/votes/#id + POST ==
Modifie le vote dont l'identifiant est passé dans #id
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/images/15
  - vote : valeur du vote (normalement entre 0 et 5)
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

== /images/#id_image/votes/#id + POST contenant action=delete ==
Supprime le vote possédant l'identifiant #id
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/images/15
  - action : doit valoir "delete" pour que la requete post soit considérée comme une suppression
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

== /votes/observations/?masque.id_proposition=#id ==
Retourne une liste de votes pour une proposition de détermination dont l'identifiant est passé dans #id
 - Type de requête : GET
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/observations/?id_proposition=205
 - Paramètres de requête disponibles : 
  - navigation.depart et navigation.limite.
  - masque.id_proposition = identifiant de proposition
 - Format retour : 
Défaut (=defaut) : JSON.

##{
    "entete": {
        "masque": " ",
        "depart": "0",
        "limite": "2",
        "total": "2"
    },
    "resultats": [
        {
            "id_vote": "285",
            "vote": "0", 
            "id_proposition" : "205",
            "auteur.id": "1588",
            "auteur.nom": "Nom",
            "auteur.prenom": "Prenom",
            "auteur.courriel": "courriel@exemple.org",
            "date": "2011-12-01"
        },
        {
            "id_vote": "247",
            "vote": "1",
            "id_proposition" : "205",
            "auteur.id": "5884",
            "auteur.nom": "Nom",
            "auteur.prenom": "Prenom",
            "auteur.courriel": "courriel@exemple.org",
            "date": "2011-12-01"
        },...
    ]
}##

== /votes/images/ + POST ==
Ajoute un vote à la proposition dont l'identifiant est passé en paramètre
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/images
 - Paramètres de requête : id
  - id_proposition : identifiant de la proposition sur laquelle on vote 
  - vote : valeur du vote (0 ou 1)
  - id_auteur : identifiant de l'auteur du vote
  - prenom_auteur : prenom de l'auteur 
  - nom_auteur : nom de l'auteur 
  - courriel_auteur : courriel de l'auteur 
  (si un identifiant est présent, les informations prenom, nom, courriel, peuvent être prises de la base de données utilisateur)
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

== /votes/observations/#id + POST ==
Modifie le vote associé dont l'identifiant est passé dans #id
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/images
  - vote : valeur du vote (0 ou 1)
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

== /votes/observations/#id + POST contenant action=delete ==
Supprime le vote dont l'identifiant est passé dans #id
 - Type de requête : POST
 - Url : http://tela-botanica.org/service:identiplante:0.1/votes/images
  - action : doit valoir "delete" pour que la requete post soit considérée comme une suppression
 - Retour : voir les codes de retour sur la page ApiIdentiplante01

Thème

Télécharger le fichier

Déjà membre

Nouveau membre

Apparence de la page ApiIdentiplante01Votes

Image de fond

Paramètres avancés