Как получить рейтинг 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 ».

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