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

---

Identiplante Api v0.1 : Propositions

Ce service fournit des informations sur les propositions.

Descriptions des paramètres de requête du service

/propositions/#id

Retourne la proposition dont l'identifiant est passé dans #id

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

Défaut (=defaut) : JSON.
{

• "id_proposition": "11",
• "id_observation": "2487",
• "nom_sel": "Abies excelsior",
• "nom_sel_nn": "3250",
• "nom_sel_nt": "2510",
• "auteur.id": "250",
• "auteur.nom": "Nom",
• "auteur.prenom": "Prenom",
• "auteur.courriel": "Courriel",
• "date": "2011-12-01",
• "commentaires": [
  • {
    • "id_commentaire": "99",
    • "texte": "Lorem ipsum dolor sit amet, consectetur adipisicing",
    • "auteur.id": "2770",
    • "auteur.prenom": "Prenom",
    • "auteur.courriel": "Courriel",
    • "date": "2011-12-01",
    • "commentaires": [ ]
  • }
• ],
• "votes": [
  • {
    • "id_vote": "17",
    • "vote": "0",
    • "auteur.id": "1588",
    • "date": "2011-12-01",
    • "auteur.nom": "Nom",
    • "auteur.prenom": "Prenom",
    • "auteur.courriel": "Courriel"
  • },
  • {
    • "id_vote": "21",
    • "vote": "1",
    • "auteur.id": "556",
    • "date": "2011-08-01",
    • "auteur.nom": "Nom",
    • "auteur.prenom": "Prenom",
    • "auteur.courriel": "Courriel"
  • }
• ]

}

/propositions/

Retourne une liste de propositions

• Type de requête : GET
• Url : http://tela-botanica.org/service:identiplante:0.1/propositions/?masque.id_observation=2555
• Paramètres de requête disponibles :
  • masque.id_observation = l'identifiant de l'observation pour laquelle on veut les propositions
• Format retour :

Défaut (=defaut) : JSON.
[

• {
  • "id_proposition": "1",
  • "id_observation": "2555",
  • "nom_sel": "Abies excelsior",
  • "nom_sel_nn": "3250",
  • "nom_sel_nt": "2510",
  • "auteur.id": "250",
  • "auteur.nom": "Nom",
  • "auteur.prenom": "Prenom",
  • "auteur.courriel": "Courriel",
  • "date": "2011-12-01",
  • "commentaires": [
    • {
      • "id_commentaire": "99",
      • "texte": "Lorem ipsum dolor sit amet, consectetur adipisicing",
      • "auteur.id": "2770",
      • "auteur.prenom": "Prenom",
      • "auteur.courriel": "Courriel",
      • "date": "2011-12-01",
      • "commentaires": [ ]
    • }
  • ],
  • "votes": [
    • {
      • "id_vote": "18",
      • "vote": "0",
      • "auteur.id": "1588",
      • "date": "2011-12-01",
      • "auteur.nom": "Nom",
      • "auteur.prenom": "Prenom",
      • "auteur.courriel": "Courriel"
    • },
    • {
      • "id_vote": "78",
      • "vote": "1",
      • "auteur.id": "556",
      • "date": "2011-08-01",
      • "auteur.nom": "Nom",
      • "auteur.prenom": "Prenom",
      • "auteur.courriel": "Courriel"
    • }
  • ]
• },
• {
  • "id_proposition": "18",
  • "id_observation": "2555",
  • "nom_sel": "Abies illustris",
  • "nom_sel_nn": "3350",
  • "nom_sel_nt": "2210",
  • "auteur.id": "255",
  • "auteur.nom": "Nom",
  • "auteur.prenom": "Prenom",
  • "auteur.courriel": "Courriel",
  • "date": "2011-12-01",
  • "commentaires": [ ],
  • "votes": [ ]
• }

]

/propositions/ + POST

Ajoute une proposition à l'observation dont l'id est passé en paramètre

• Type de requête : POST
• Url : http://tela-botanica.org/service:identiplante:0.1/propositions/
  • id_observation : l'identifiant de l'observation sur laquelle on ajoute la proposition
  • nom_sel : nom scientifique proposé
  • nom_sel_nn : numéro nomenclatural du nom scientifique proposé
  • nom_referentiel : nom du référentiel taxonomique (ex.: bdtfx_v1)
  • (les nt, nom_ret, et nom_ret_nn devraient être calculé automatiquement à partir du nom_sel_nn et du reférentiel)
  • id_auteur : identifiant de l'auteur de la proposition
  • 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

/proposition/#id + POST

Modifie la proposition dont l'identifiant est passé dans #id

• Type de requête : POST
• Url : http://tela-botanica.org/service:identiplante:0.1/propositions/14
  • nom_sel : nom scientifique proposé
  • nom_sel_nn : numéro nomenclatural du nom scientifique proposé
  • nom_referentiel : nom du référentiel taxonomique (ex.: bdtfx_v1)
  • (les nt nom_ret, nom_ret_nn devraient être calculé automatiquement à partir du nom_sel_nn et du reférentiel)
  • Retour : voir les codes de retour sur la page ApiIdentiplante01

/propositions/#id + POST contenant action=delete

Supprime la proposition possédant l'identifiant #id

• Type de requête : POST
• Url : http://tela-botanica.org/service:identiplante:0.1/propositions/14
  • 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