Comment obtenir les évaluations de Goodreads via l'API

Pour les amateurs de livres qui ont un goût pour un genre spécifique, ils vont probablement vérifier la recommandation d'un ami que de suivre une liste de best-sellers. C'est pourquoi Amazon Goodreads est un site favori pour les lecteurs avides. C'est un endroit où vous pouvez trouver une vaste base de données de livres, des recommandations et des critiques par d'autres amateurs de livres.

Goodreads fournit également une API permettant aux développeurs d' accéder à ses données et de les personnaliser davantage selon notre application. Aujourd'hui, nous verrons comment récupérer les classements des livres Goodreads via l'API Goodreads en utilisant le numéro ISBN ou le numéro international standard du livre, qui peut être utilisé ultérieurement lors de l'affichage des informations sur les livres et autres sur votre site Web.

Pour commencer, connectez-vous ou inscrivez-vous avec un nom, un email et un mot de passe à Goodreads et allez sur https://www.goodreads.com/api/keys (lien). Entrez un nom d'application et un nom de société et générez votre clé API. Ensuite, vérifiez votre compte via l'e-mail reçu dans l'e-mail que vous avez entré.

Assurez-vous de consulter les conditions d'utilisation du développeur pour l'API. Ils ont également une liste de méthodes API dans leur page API, certaines de ces méthodes nécessiteront une authentification OAuth, le reste n'aura besoin que de la clé développeur, comme celle que nous verrons dans ce post.

Le type de réponse de ces méthodes varie, que ce soit en XML ou en JSON, ou une option permettant de choisir entre ces deux méthodes en utilisant le paramètre format .

book.review_counts est une méthode de l'API Goodreads qui récupère toutes les statistiques de révision pour une liste d'ISBN de livre. Son type de réponse est JSON. L'URL de la requête est comme ceci: https://www.goodreads.com/book/review_counts.json.

Il faut quatre paramètres:

• key, qui est la clé du développeur
• isbns - un tableau ou une seule chaîne séparée par des virgules des numéros ISBN des livres que nous voulons consulter
• format - le format de la réponse (bien qu'en toute honnêteté, je ne suis pas vraiment sûr de la raison pour laquelle celle-ci existe, puisque la réponse sera toujours en JSON.) Des plans pour de futures implémentations?)
• callback, la fonction qui encapsulera la réponse JSON

Prenons les deux livres; Tête d'abord Java, première édition (ISBN: 0596009208) et JavaScript: The Good Parts, 1ère édition (ISBN: 0596517742) et obtenir leurs statistiques d'examen. L'URL de la requête est comme ceci:

 https://www.goodreads.com/book/review_counts.json?key={apikey}&isbns=0596009208, 0596517742 

Et la responseText après l'embellissement ressemble à ceci.

 {"livres": [{"id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "ratings_count": 1842, "reviews_count": 3599, "text_reviews_count": 124, "work_ratings_count" : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "average_rating": "4.16"}, {"id": 2998152, "isbn": "0596517742", "isbn13": "9780596517748", "ratings_count" : 4430, "reviews_count": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "average_rating": "4.22"}]} 

Si vous voulez la note du livre Head First Java, First Edition, c'est dans myJSON.books[0].average_rating . Les ratings_count et reviews_count des objets représentent le nombre total de notes attribuées et les avis émis pour cette édition particulière du livre.

De même, text_reviews_count représente l'ensemble des révisions en texte seul de l'édition particulière du livre. Considérant que work_ratings_count, work_reviews_count et work_text_reviews_count représentent le nombre total d'évaluations, d'avis et de commentaires textuels de toutes les éditions.

Si vous cliquez sur Rating Details of JavaScript: The Good Parts (1ère édition) dans Goodreads, il s'affichera.

Vous pouvez utiliser toutes ces informations supplémentaires si vous le souhaitez ou simplement afficher une note pour le livre en utilisant la valeur de la clé average_rating .

Remarque : Selon la documentation de l'API, «L'API Goodreads vous donne un accès complet aux métadonnées appartenant à Goodreads, mais elle ne vous donne pas un accès complet aux métadonnées de livre fournies par des tiers tels qu'Ingram. Les images de couverture de livres, les descriptions et autres données provenant de sources tierces pourraient être exclues, car nous ne disposons pas d'une licence pour distribuer ces données via notre API. "

Une fois que vous avez préparé les couvertures et les descriptions de livres, vous pouvez afficher les informations du livre un peu comme ci-dessous.