Evaluation simplifiée d’une fiche

Cette méthode permet de récupérer l’évaluation simplifié d’une fiche.

Par défaut, l’API offre une réponse au format JSON. Pour bénéficier d’une réponse en XML, vous devez placer dans votre requête un header de type « Accept » avec la valeur « application/xml ».

GET https://api.monaviscompte.fr/ratings/:id?private_key=:private_key

 

Exemple : https://api.monaviscompte.fr/ratings/794173?private_key=efr9-kk7p-ah68-j9nw

nom requis type description
id oui int identifiant de la fiche
private_key oui string clé d’authentification privée
nom type description
grade float la note de la fiche entre 0 et 5
all_reviews_count int le nombre d’avis déposés sur la fiche
click_to_review string le lien permettant le dépôt d’avis express depuis votre site, les réseaux sociaux, une campagne emailing. L’URL retournée est relative à la version de monaviscompte que vous utilisez (probablement https://www.monaviscompte.fr/)
code de retour raison
HTTP 200 succès
HTTP 401 authentification échouée
HTTP 404 la fiche n’existe pas
{
    "grade": 3.9,
    "all_reviews_count": 342,
    "click_to_review": "depot-express-avis/a22k-hjq9-hkp5-32cb/1082"
}
<rating>
    <all_reviews_count>342</all_reviews_count>
    <click_to_review>
        depot-express-avis/a22k-hjq9-hkp5-32cb/1082
    </click_to_review>
    <grade>3.9</grade>
</rating>