Miten saada Goodreads-luokitukset API n kautta
Kirjan ystäville, jotka haluavat tietyn tyylilajin, he luultavasti katsovat ystävänsä suosituksen kuin noudattavat bestseller-luetteloa. Tämän vuoksi Amazon's Goodreads on kirjanmerkkinen sivusto innokkaille lukijoille. Se on paikka, josta löydät kattavan tietokannan kirjoista, suosituksista ja arvosteluista muiden kirjailijoiden ystäville.
Goodreads tarjoaa myös API: n kehittäjille käyttää tietojaan ja mukauttaa niitä se on hakemuksemme mukaan. Tänään näemme, miten voit hakea Goodreads-kirjan arvosanat Goodreadsin sovellusliittymän kautta käyttämällä ISBN-numeroa tai kansainvälistä Standard Book -numeroa, jota voidaan myöhemmin käyttää, kun näytetään kirjan tietoja ja sellaisia sivustossasi.
Voit aloittaa joko kirjautumalla tai rekisteröidy nimellä, sähköpostiosoitteella ja salasanalla Goodreadsille ja mene osoitteeseen https://www.goodreads.com/api/keys (linkki). Anna sovelluksen nimi ja yrityksen nimi ja luo API-avain. Tarkista sitten tilisi antamasi sähköpostitunnuksen kautta.
Muista tarkistaa kehittäjän käyttöehdot käyttöliittymälle. Niillä on myös API-sivujen luettelo API-sivuiltaan, jotkut näistä menetelmistä edellyttävät OAuth-todennusta, loput vain tarvitsevat kehittäjäavaimen, kuten se, jota tarkastelemme tässä viestissä.
Näiden menetelmien vastaustyyppi vaihtelee, se on joko vain XML: ssä tai JSON: ssa, tai vaihtoehto valita näiden kahden välillä muoto parametri.
book.review_counts on Goodreads API -menetelmä, joka noutaa kaikki kirjan ISBN-luettelon tarkistustilastot. Sen vastaustyyppi on JSON. Pyynnön URL-osoite on näin: https://www.goodreads.com/book/review_counts.json .
Se kestää neljä parametria:
avain, joka on kehittäjäavainISBN-numerot- joukko tai yksittäinen pilkulla erotettu kirjo kirjoista, joita haluamme tarkistaa tilastoistamuoto- vastausmuoto (vaikka olen täysin rehellisesti sanottuna, en ole varma, miksi tämä on olemassa, koska vastaus tulee aina olemaan JSON: ssa. Suunnitelmat tulevia toteutuksia varten?)soita takaisin, toiminto, joka käärittää JSON-vastauksen
Otetaan kaksi kirjaa; Head First Java, ensimmäinen painos (ISBN: 0596009208) ja JavaScript: The Good Parts, 1. painos (ISBN: 0596517742) ja saada niiden tilastotiedot. Pyynnön URL-osoite on näin:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
Ja responseText kaunistamisen jälkeen näyttää tältä.
"books": ["id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "rating_count": 1842, "reviews_count": 3599, "text_reviews_count": 124, "work_ratings_count": : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "keskimääräinen_käyttö": "4.16", "id": 2998152, "isbn": "0596517742", "isbn13": "9780596517748", "rating_count" : 4430, "reviews_count": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "keskimääräinen_summa": "4.22"]
Jos haluat arvosanan Head First Java, ensimmäinen painos kirja, se on myJSON.books [0] .average_rating. RATINGS_COUNT ja reviews_count Objektien avaimet edustavat kokonaisarvoa annetuista arvosanoista ja arvioista, jotka on tehty kyseiselle teokselle.
samalla lailla , text_reviews_count edustaa koko kirjan vain kyseisen painoksen tekstin tarkastelua. taas work_ratings_count, work_reviews_count ja work_text_reviews_count edustavat kaikkien versioiden kokonaisarvioita, arvioita ja vain tekstiä koskevia arvosteluja.
Jos napsautat Rating Details of JavaScript: The Good Parts (1. painos) Goodreadsissa se näytetään.
Voit käyttää kaikkia näitä ylimääräisiä arviointitietoja, jos haluat tai vain näyttää tähden arvosanan käyttämällä keskimääräinen arvio avainarvo.
Huomautus: API-dokumentaation mukaan, “Goodreadsin sovellusliittymä antaa sinulle täyden pääsyn Goodreadsin omistamiin metatietoihin, mutta se ei anna sinulle täyttä pääsyä kolmansien osapuolten, kuten Ingramin, toimittamiin kirjan metatietoihin. Kirjan kansikuvat, kuvaukset ja muut kolmansien osapuolten lähteistä saatavat tiedot voivat olla poissuljettuja, koska meillä ei ole lupaa jakaa näitä tietoja API: n kautta.”
Kun olet lukenut kirjan kannet ja kuvaukset, voit näyttää jonkin verran alla olevaa kirjan tietoja.
