Kuidas saada Goodreadsi reitinguid API kaudu
Raamatusõpradele, kes armastavad teatud žanri, vaatavad nad tõenäoliselt sõbra soovitust, kui järgivad bestsellerite nimekirja. See on põhjus, miks Amazon's Goodreads on järjehoidjaga veebisait innukate lugejate jaoks. See on koht, kus saab leida raamatute, soovituste ja ülevaadete põhjalikku andmebaasi raamatuõpilaste poolt.
Goodreads pakub ka API arendajatele juurdepääsu oma andmetele ja isikupärastada see on meie taotluse järgi. Täna näeme, kuidas hankida Goodreadsi raamatu reitingud Goodreadsi API kaudu ISBNi või rahvusvahelise standardiraamatu numbri abil, mida saab hiljem kasutada raamatuteabe ja sellel veebisaidil kuvamise ajal.
Alustamiseks logi sisse või registreeruge Goodreadsi nimele, e-posti ID-le ja paroolile ning minge https://www.goodreads.com/api/keys (link). Sisestage rakenduse nimi ja ettevõtte nimi ning looge oma API-võti. Seejärel kontrollige oma kontot sisestatud e-posti idis saadud e-posti kaudu.
Kontrollige kindlasti API arendaja teenusetingimusi. Neil on ka API API-lehekülgede nimekiri, mõned neist meetoditest nõuavad OAuth autentimist, ülejäänud ainult vaja arendaja võtit, nagu see, mida me selles postituses vaatame.
Nende meetodite vastusetüüp on erinev, see on kas ainult XML-is või JSON-is või võimalus valida nende kahe vahel vormingus parameeter.
book.review_counts on Goodreadsi API-meetod, mis tõmbab kõik raamatu ISBN-lehtede ülevaatuse statistika. Selle tüüp on JSON. Päringu URL on selline: https://www.goodreads.com/book/review_counts.json .
See võtab neli parameetrit:
võti, mis on arendaja võtiIsbns- massiivi või ühe komaga eraldatud raamatute ISBN-ridade string, mida me soovime vaadatavormingus- vastuse vorming (kuigi ausalt öeldes ei ole ma päris kindel, miks see on olemas, sest vastus on alati JSONis. Tulevaste rakenduste plaanid?)helista tagasi, funktsioon, mis loob JSON-i vastuse
Võtame kaks raamatut; Pea esimene Java, esimene väljaanne (ISBN: 0596009208) ja JavaScript: The Good Parts, 1. väljaanne (ISBN: 0596517742) ja saada nende ülevaatuse statistika. Päringu URL on selline:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
Ja vastusTekst pärast kaunistamist näeb välja selline.
"books": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "rating_count": 1842, "arvustuste arv": 3599, "text_reviews_count": 124, "work_ratings_count": : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "keskmist väärtust": "4.16", "id": 2998152, "isbn": "0596517742", "isbn13": "9780596517748", "rating_count" : 4430, "arvustuste arv": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "keskmine_väärtus": "4.22"]
Kui soovite Pea esimese Java, esimese väljaande pea raamat, see on sees myJSON.books [0] .average_rating. The rating_count ja arvustuste arv objektide võtmed esindavad antud raamatu konkreetse väljaande kohta antud hinnangute koguarvu ja kommentaare.
Samamoodi , text_reviews_count kujutab raamatu konkreetse väljaande ainult teksti ainult ülevaatusi. Arvestades, et work_ratings_count, work_reviews_count ja work_text_reviews_count esindavad kõigi väljaannete kogu hinnanguid, ülevaateid ja ainult teksti ülevaatusi.
Kui klõpsate Reitingu üksikasjad kohta JavaScript: head osad (1. väljaanne) Goodreads'is kuvatakse see.
Võite kasutada kõiki neid täiendavaid ülevaatamisandmeid, kui soovite või lihtsalt kuvatakse raamatu tärnide arv keskmine hinne võtme väärtus.
Märge: Vastavalt API dokumentatsioonile, “Goodreadsi API annab teile täieliku juurdepääsu Goodreadsi omandis olevatele metaandmetele, kuid see ei anna teile täielikku juurdepääsu kolmandate osapoolte, näiteks Ingrami, esitatud metaandmetele. Raamatukaane pildid, kirjeldused ja muud andmed kolmandate osapoolte allikatest võivad olla välistatud, sest meil ei ole litsentsi nende andmete levitamiseks meie API kaudu.”
Kui olete raamatukaaned ja -kirjeldused valmis, saate kuvada raamatuinfo allpool.
