Bagaimana Mendapatkan Penilaian Baik melalui API

Bagi pencinta buku yang suka untuk genre tertentu, mereka mungkin akan menyemak cadangan rakan daripada mengikuti mana-mana senarai bestseller. Itulah sebabnya Amazon's Goodreads adalah tapak bookmark untuk pembaca yang gemar. Ia adalah tempat di mana anda boleh mencari pangkalan data buku, cadangan dan ulasan yang banyak oleh pencinta buku sesama.

Goodreads juga menyediakan API untuk pemaju untuk akses datanya dan peribadikan lagi ia mengikut permohonan kami. Hari ini kita akan melihat cara untuk mendapatkan penilaian buku Goodreads melalui API Goodreads menggunakan ISBN atau Nombor Buku Standard Antarabangsa, yang kemudiannya boleh digunakan semasa memaparkan maklumat buku dan sebagainya di laman web anda.

Untuk memulakan, sama ada log masuk atau mendaftar dengan nama, id e-mel dan kata laluan untuk Goodreads dan pergi ke https://www.goodreads.com/api/keys (pautan). Masukkan sebarang nama aplikasi dan nama syarikat dan buatkan kunci API anda. Kemudian sahkan akaun anda melalui e-mel yang diterima dalam id e-mel yang anda masukkan.

Pastikan untuk menyemak Syarat Perkhidmatan Pemaju mereka untuk API. Mereka juga mempunyai senarai kaedah API dalam halaman API mereka, beberapa kaedah tersebut memerlukan pengesahan OAuth, selebihnya hanya akan memerlukan kunci pemaju, seperti yang kita akan lihat dalam siaran ini.

Jenis respon bagi kaedah tersebut berbeza-beza, sama ada hanya dalam XML atau JSON, atau pilihan untuk memilih antara kedua-duanya menggunakan format parameter.

book.review_counts adalah kaedah API Goodreads yang akan mengambil semua statistik ulasan untuk senarai buku ISBN. Jenis responnya ialah JSON. URL permintaan adalah seperti ini: https://www.goodreads.com/book/review_counts.json .

Ia mengambil masa empat parameter:

kunci, yang merupakan kunci pemaju
isbns - rentetan atau rentetan koma yang dipisahkan dari ISBN buku-buku yang kami mahu statistik ulasan
format - format respon (walaupun dalam semua kejujuran, saya tidak benar-benar yakin mengapa ini wujud, kerana sambutan akan sentiasa berada di JSON. Rancangan untuk pelaksanaan masa depan?)
panggilan balik, fungsi yang akan membungkus tindak balas JSON

Mari kita ambil dua buku itu; Kepala Jenderal Pertama, Edisi Pertama (ISBN: 0596009208) dan JavaScript: Bahagian Baik, edisi pertama (ISBN: 0596517742) dan mendapatkan statistik ulasan mereka. URL permintaan seperti ini:

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

Dan juga responseText selepas mencantikkan kelihatan seperti ini.

"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, "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"]

Sekiranya anda mahukan penarafan Ketua Jawa Pertama, Edisi Pertama buku, ia masuk myJSON.books [0] .average_rating. The ratings_count dan reviews_count kunci dalam objek mewakili jumlah bilangan penilaian penilaian dan dibuat untuk edisi tertentu buku itu.

Begitu juga , text_reviews_count mewakili jumlah ulasan teks sahaja edisi buku tertentu. Sedang work_ratings_count, work_reviews_count dan work_text_reviews_count mewakili keseluruhan penilaian, ulasan dan ulasan teks sahaja bagi semua edisi.

Sekiranya anda klik pada Butiran Penilaian mengenai JavaScript: Bahagian Baik (Edisi 1) dalam Goodreads ia akan memaparkannya.

Anda boleh menggunakan semua maklumat semakan tambahan jika anda mahu atau hanya memaparkan penarafan bintang untuk buku menggunakan penilaian purata nilai utama.

Catatan: Menurut documenation API, “API Goodreads memberikan anda akses penuh ke data meta milik Goodreads, tetapi ia tidak memberi anda akses penuh untuk meta-data buku yang dibekalkan oleh pihak ketiga seperti Ingram. Imej perlindungan gambar, perihalan, dan data lain dari sumber pihak ketiga mungkin dikecualikan, kerana kami tidak mempunyai lesen untuk mengedarkan data ini melalui API kami.”

Sebaik sahaja anda menyiapkan cover buku dan penerangan, anda boleh memaparkan maklumat buku yang agak seperti di bawah.