Jak získat hodnocení Goodreads přes API

Pro milovníky knih, kteří mají rádi konkrétní žánr, budou pravděpodobně vyzkoušet doporučení přítele, než sledovat jakýkoli seznam bestsellerů. To je důvod, proč je Amazon's Goodreads záložkou stránek pro vášnivé čtenáře. Je to místo, kde můžete najít rozsáhlou databázi knih, doporučení a recenze kolegy milovníky knih.

Goodreads také poskytuje API pro vývojáře přístup k datům a dále personalizovat podle naší aplikace. Dnes uvidíme, jak získat hodnocení knih Goodreads prostřednictvím rozhraní API Goodreads pomocí čísla ISBN nebo Mezinárodního standardního čísla knihy, které lze později použít při zobrazování informací o knihách a na webových stránkách..

Chcete-li začít, buď se přihlaste, nebo se zaregistrujte se jménem, e-mailem a heslem do Goodreads a přejděte na stránku https://www.goodreads.com/api/keys (odkaz). Zadejte název aplikace a název společnosti a vygenerujte klíč API. Poté svůj účet ověřte prostřednictvím e-mailu, který jste obdrželi v zadaném e-mailu.

Nezapomeňte se podívat na jejich smluvní podmínky pro vývojáře rozhraní API. Oni také mají seznam API metod v jejich API stránce, některé těch metod bude vyžadovat OAuth ověřování, zbytek bude jen potřebovat klíč vývojáře, stejně jako ten, na který se podíváme v tomto příspěvku.

Typ odezvy těchto metod se liší, je to buď pouze v XML nebo JSON, nebo možnost volby mezi těmito dvěma způsoby formát parametr.

book.review_counts je metoda API Goodreads, která přinese všechny přehledové statistiky pro seznam knih ISBN. Její typ odezvy je JSON. Adresa URL požadavku je takto: https://www.goodreads.com/book/review_counts.json .

Má čtyři parametry:

klíč, který je klíčem vývojáře
isbns - pole nebo jeden čárkou oddělený řetězec ISBN knih, které chceme přezkoumat
formát - formát odpovědi (i když ve všech upřímnost, nejsem si opravdu jistý, proč to existuje, protože odpověď bude vždy bude v JSON. Plány pro budoucí implementace?)
zpětné volání, funkce, která zabalí odpověď JSON

Vezmeme dvě knihy; Head First Java, První vydání (ISBN: 0596009208) a JavaScript: The Good Parts, 1. vydání (ISBN: 0596517742) a získat jejich přehledové statistiky. Adresa URL požadavku je takto:

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

A responseText po zkrášlení vypadá takto.

"books": ["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"]

Pokud chcete hodnocení Head First Java, první vydání kniha, je to v myJSON.books [0] .verage_rating. ratings_count a reviews_count klíče v objektech představují celkový počet hodnocení a hodnocení provedených pro dané vydání knihy.

Podobně , text_reviews_count představuje celkové textové recenze konkrétního vydání knihy. Zatímco work_ratings_count, work_reviews_count a work_text_reviews_count představují celkové hodnocení, recenze a textové recenze všech vydání.

Pokud kliknete na Detaily hodnocení JavaScript: Dobré díly (1. vydání) v Goodreads to zobrazí.

Můžete použít všechny tyto další informace o recenzi, pokud chcete, nebo jen zobrazit hvězdičku pro knihu pomocí průměrné hodnocení hodnota klíče.

Poznámka: Podle dokumentace API, “Rozhraní API Goodreads poskytuje úplný přístup k metaúdajům ve vlastnictví společnosti Goodreads, ale neposkytuje vám úplný přístup k metaúdajům, které poskytují třetí strany, například Ingram. Obrázky, popisy a další údaje ze zdrojů třetích stran mohou být vyloučeny, protože nemáme povolení k distribuci těchto dat prostřednictvím našeho rozhraní API.”

Jakmile si přečtete obálky a popisy knih, můžete zobrazit informace o knize tak, jak je uvedeno níže.