Cum să obțineți evaluări pentru Goodreads prin API

Pentru iubitorii de cărți care preferă un anumit gen, probabil că vor verifica recomandările unui prieten decât să urmeze lista bestseller-urilor. Acesta este motivul pentru care Amazon's Goodreads este un site marcat pentru cititorii avid. Este un loc unde puteți găsi o bază vastă de cărți, recomandări și recenzii de către iubitorii de cărți.

Goodreads oferă, de asemenea, un API pentru dezvoltatori să acceseze datele sale și să le personalizeze în continuare conform cererii noastre. Astăzi vom vedea cum să regăsim evaluările de carte Goodreads prin intermediul API-ului Goodreads, utilizând numărul ISBN sau numărul standard internațional de carte, care poate fi folosit ulterior în timpul afișării informațiilor despre cărți și a acestora pe site-ul dvs..

Pentru a începe, conectați-vă sau creați un nume, un e-mail și o parolă la Goodreads și accesați-o https://www.goodreads.com/api/keys (legătură). Introduceți numele aplicației și numele companiei și generați cheia API. Apoi, verificați-vă contul prin e-mailul primit în id-ul de e-mail pe care l-ați introdus.

Asigurați-vă că verificați Termenii și condițiile pentru dezvoltatori pentru API. Ei au, de asemenea, o listă de metode API în pagina API, unele dintre aceste metode necesită autentificare OAuth, restul va au nevoie de cheia dezvoltatorului, ca la cea pe care o vom uita în acest post.

Tipul de răspuns al acestor metode variază, fie este doar în XML sau JSON, sau o opțiune de a alege între aceste două folosind format parametru.

book.review_counts este o metodă Goodreads API care va prelua toate statisticile de recenzie pentru o listă de ISBN-uri de carte. Tipul său de răspuns este JSON. Adresa URL a solicitării este astfel: https://www.goodreads.com/book/review_counts.json .

Este nevoie de patru parametri:

cheie, care este cheia dezvoltatorului
Coduri ISBN - un șir sau un singur șir separat prin virgulă a codurilor ISBN ale cărților pe care le dorim statisticile de examinare din
format - formatul răspunsului (deși cu toată onestitatea, nu sunt sigur de ce există, deoarece răspunsul va fi întotdeauna în JSON.) Planuri pentru implementări viitoare?)
suna inapoi, funcția care va încheia răspunsul JSON

Să luăm cele două cărți; Head First Java, prima ediție (ISBN: 0596009208) și JavaScript: piesele bune, prima ediție (ISBN: 0596517742) și obțineți statisticile de recenzie. Adresa URL a solicitării este următoarea:

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

Si responseText după înfrumusețare arata așa.

"cărți": "" id ": 231262," isbn ":" 0596009208 "," isbn13 ":" 9780596009205 "," ratings_count ": 1842," reviews_count ": 3599," work_ratings_count " : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "average_rating": "4.16", : 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"]

Dacă doriți evaluarea Șef prima Java, prima ediție carte, e în myJSON.books [0] .average_rating. RATINGS_COUNT și reviews_count cheile din obiecte reprezintă numărul total de evaluări exprimate și recenziile făcute pentru respectiva ediție a cărții.

asemănător , text_reviews_count reprezintă revizuirile totale ale textului numai pentru ediția specială a cărții. Întrucât work_ratings_count, work_reviews_count și work_text_reviews_count reprezintă evaluările totale, recenziile și recenziile numai pentru text ale tuturor edițiilor.

Dacă dați clic pe Detalii de evaluare JavaScript: piesele bune (prima ediție) în Goodreads o să afișeze asta.

Puteți folosi toate aceste informații suplimentare de revizuire dacă doriți sau afișați doar o evaluare de stele pentru carte folosind rata medie valoare cheie.

Notă: Potrivit documentației API, “API-ul Goodreads vă oferă acces deplin la meta-date deținute de Goodreads, dar nu vă oferă acces complet la metadatele de date furnizate de terțe părți, cum ar fi Ingram. S-ar putea exclude imaginile de acoperire a cărților, descrierile și alte date din surse terță parte, deoarece nu avem o licență pentru a distribui aceste date prin API-ul nostru.”

Odată ce ați pregătit cărțile și descrierile cărților, puteți afișa informațiile despre cărți cumva mai jos.