Как получить рейтинг Goodreads через API

Для любителей книг, которым нравится определенный жанр, они, вероятно, проверят рекомендацию друга, а не будут следовать списку бестселлеров. Вот почему Амазонки Goodreads это сайт с закладками для заядлых читателей. Это место, где вы можете найти обширную базу данных книг, рекомендаций и обзоров от других любителей книг.

Goodreads также предоставляет разработчикам API-интерфейс для доступа к своим данным и дальнейшей персонализации их в соответствии с нашим приложением. Сегодня мы увидим, как получить рейтинги книг Goodreads через API Goodreads, используя ISBN или международный стандартный номер книги, который впоследствии можно будет использовать при отображении информации о книге и т. Д. На вашем веб-сайте.

Для начала либо войдите либо Подписаться с именем, идентификатором электронной почты и паролем к Goodreads и перейдите к https://www.goodreads.com/api/keys (ссылка на сайт). Введите любое имя приложения и название компании и сгенерируйте свой ключ API. Затем подтвердите свою учетную запись, указав адрес электронной почты, который вы указали.

Обязательно ознакомьтесь со своими Условия использования для разработчиков для API. У них также есть список методов API в их Страница APIнекоторые из этих методов потребуют OAuth-аутентификацияостальным понадобится только ключ разработчика, как тот, который мы рассмотрим в этом посте.

Подробнее: Как отобразить данные спецификации W3C с помощью веб-API

Тип ответа этих методов может быть разным, он либо только в XML или JSON, либо есть возможность выбора между этими двумя параметрами с помощью параметра format.

book.review_counts — это метод API Goodreads, который извлекает всю статистику обзора для списка ISBN книг. Тип ответа — JSON. URL-адрес запроса выглядит следующим образом: https://www.goodreads.com/book/review_counts.json ,

Требуется четыре параметра:

• ключ, который является ключом разработчика
• isbns — массив или отдельная запятая строка номеров ISBN книг, для которых мы хотим получить статистику обзора
• format — формат ответа (хотя, честно говоря, я не совсем уверен, почему он существует, так как ответ всегда будет в JSON. Планы на будущие реализации?)
• обратный вызов, функция, которая обернет ответ JSON

Давайте возьмем две книги; Head First Java, Первое издание (ISBN: 0596009208) и JavaScript: хорошие части, 1-е издание (ISBN: 0596517742) и получите их обзорную статистику. URL-адрес запроса выглядит следующим образом:
https://www.goodreads.com/book/review_counts.json?key={apikey}&isbns=0596009208,0596517742

И текст отклика после украшения выглядит следующим образом.
{ «книги»:
[ { «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"}
    ]}

Если вы хотите, чтобы рейтинг Head First Java, первое издание книга, это в myJSON.books[0].средний рейтинг. Ключи Rating_count и reviews_count в объектах представляют общее количество оценок и обзоров, сделанных для данного конкретного издания книги.

Точно так же text_reviews_count представляет собой общие текстовые обзоры конкретного издания книги. Принимая во внимание, что work_ratings_count, work_reviews_count и work_text_reviews_count представляют собой общие оценки, обзоры и текстовые обзоры всех выпусков.

Если вы нажмете на рейтинг детали JavaScript: хорошие части (1-е издание) в Goodreads это будет отображаться.
Вы можете использовать всю эту дополнительную рецензионную информацию, если хотите, или просто отображать звездный рейтинг для книги, используя значение ключа Average_rating.

Примечание. Согласно документации API «API Goodreads предоставляет вам полный доступ к метаданным, принадлежащим Goodreads, но не дает полного доступа к метаданным книги, предоставленным третьими лицами, такими как Ingram. Изображения обложек книг, описания и другие данные из сторонних источников могут быть исключены, поскольку у нас нет лицензии на распространение этих данных через наш API ».

После того, как вы подготовили обложки и описания книг, вы можете отобразить информацию о книге, как показано ниже.