Hoe u Goodreads-beoordelingen kunt krijgen via API

Voor boekenliefhebbers die een voorkeur hebben voor een specifiek genre, zullen ze waarschijnlijk de aanbeveling van een vriend bekijken dan een lijst met bestsellers te volgen. Dit is de reden waarom Amazon's Goodreads een site is met bladwijzers voor enthousiaste lezers. Het is een plaats waar je een uitgebreide database van boeken, aanbevelingen en beoordelingen kunt vinden door boekliefhebbers.

Goodreads biedt ook een API voor ontwikkelaars om toegang te krijgen tot zijn gegevens en deze verder te personaliseren volgens onze applicatie. Vandaag zullen we zien hoe we GoodReads-boekbeoordelingen kunnen ophalen via de Goodreads API met behulp van het ISBN- of International Standard Book Number, dat later kan worden gebruikt terwijl boekinformatie en dergelijke op uw website worden weergegeven.

Om te beginnen logt u in of tekent u in met een naam, e-mailadres en wachtwoord voor Goodreads en gaat u naar https://www.goodreads.com/api/keys (link). Voer de naam van een toepassing en de bedrijfsnaam in en genereer uw API-sleutel. Verifieer vervolgens uw account via de e-mail die u heeft ontvangen in het e-mailadres dat u hebt ingevoerd.

Raadpleeg de Servicevoorwaarden voor ontwikkelaars voor de API. Ze hebben ook een lijst met API-methoden op hun API-pagina, voor sommige van deze methoden is OAuth-verificatie vereist, voor de rest is alleen de ontwikkelaarssleutel nodig, zoals de sleutel die we in deze post zullen bekijken.

Het antwoordtype van die methoden varieert, het is alleen in XML of JSON, of een optie om tussen deze twee te kiezen met behulp van de parameter format .

book.review_counts is een Goodreads API-methode die alle review-statistieken voor een lijst met boek-ISBN's ophaalt. Het antwoordtype is JSON. De aanvraag-URL is als volgt: https://www.goodreads.com/book/review_counts.json.

Er zijn vier parameters nodig:

• key, de ontwikkelaarssleutel
• isbns - een array of enkele door komma's gescheiden string van de ISBN's van de boeken waarnaar we de beoordelingsstatistieken van willen
• format - het formaat van de reactie (hoewel ik eerlijk gezegd niet echt zeker weet waarom deze bestaat, omdat de reactie altijd in JSON zal zijn. Plannen voor toekomstige implementaties?)
• callback, de functie die het JSON-antwoord afrondt

Laten we de twee boeken nemen; Head First Java, First edition (ISBN: 0596009208) en JavaScript: The Good Parts, 1st edition (ISBN: 0596517742) en ontvang hun beoordelingsstatistieken. De aanvraag-URL is als volgt:

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

En de responseText na het verfraaien ziet er zo uit.

 {"books": [{"id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "ratings_count": 1842, "beoordelingen_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", "beoordelingen_count" : 4430, "beoordelingen_count": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text zelfstandige_count": 381, "average_rating": "4.22"}]} 

Als je de beoordeling van het Head First Java, First Edition- boek wilt hebben, staat deze in myJSON.books[0].average_rating . De toetsen ratings_count en beoordelingen_count in de objecten vertegenwoordigen het totale aantal ratings_count en beoordelingen voor die bepaalde editie van het boek.

Op dezelfde text_reviews_count vertegenwoordigt text_reviews_count de totale tekstuele recensies van de specifieke editie van het boek. Terwijl work_ratings_count, work_reviews_count en work_text_reviews_count de totale beoordelingen, recensies en alleen- work_text_reviews_count van alle edities vertegenwoordigen.

Als u in Goodreads op Beoordelingsdetails van JavaScript: de goede onderdelen (1e editie) klikt, wordt dit weergegeven.

U kunt al die extra recensie-informatie gebruiken als u dat wilt, of u kunt gewoon een average_rating voor het boek weergeven met de waarde van de average_rating waarde van de waarde.

Opmerking : volgens de API-documentatie, "De Goodreads API geeft u volledige toegang tot metadata van Goodreads, maar u hebt geen volledige toegang tot boekmetagegevens die zijn geleverd door derde partijen zoals Ingram. Boekomslagafbeeldingen, beschrijvingen en andere gegevens van externe bronnen kunnen worden uitgesloten, omdat we geen licentie hebben om deze gegevens via onze API te distribueren. "

Nadat u de boekomslagen en beschrijvingen hebt voorbereid, kunt u de boekinformatie enigszins weergeven zoals hieronder.