Retour : page principale > sommaire eFlore v5 > Identiplante > 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