כיצד לקבל דירוגים טובים דרך API
לאוהבי הספרים שיש להם חיבה לז'אנר מסוים, הם בטח יבדקו את המלצתו של חבר מאשר יעברו לרשימת רבי-מכר. זו הסיבה Goodreds של אמזון הוא אתר סימניות עבור הקוראים נלהב. זה מקום שבו אתה יכול למצוא מסד נתונים נרחב של ספרים, המלצות וסקירות על ידי אוהבי ספרים אחרים.
Goodreads גם מספק API עבור מפתחים לגשת לנתונים שלה ולהתאים אישית זה לפי הבקשה שלנו. היום נראה כיצד לאחזר דירוגים Goodreads הספר דרך ה- Goodreads API באמצעות ISBN או מספר ספר רגיל בינלאומי, אשר מאוחר יותר ניתן להשתמש בעת הצגת מידע הספר כגון באתר האינטרנט שלך.
כדי להתחיל, או להתחבר או להירשם עם שם, מזהה דוא"ל וסיסמה כדי Goodreads וללכת https://www.goodreads.com/api/keys (קישור). הזן שם יישום ושם חברה וליצור את מפתח ה- API שלך. לאחר מכן אמת את החשבון שלך באמצעות האימייל שהתקבל במזהה האימייל שהזנת.
הקפד לבדוק את התנאים וההגבלות למפתחים עבור ממשק ה- API. יש להם גם רשימה של שיטות API בדף ה- API שלהם, חלק משיטות אלה ידרוש אימות OAuth, והשאר יהיה רק צריך מפתח מפתח, כמו זה שנביט בפוסט הזה.
סוג התגובה של שיטות אלה משתנה, זה רק ב- XML או JSON, או אפשרות לבחור בין שני אלה באמצעות פורמט פרמטר.
הספר היא שיטת ה- Goodreads API שתביא את כל הנתונים הסטטיסטיים של הסקירה עבור רשימה של מספרי ISBN של ספרים. סוג התגובה שלה הוא JSON. כתובת האתר של הבקשה היא כך: https://www.goodreads.com/book/review_counts.json .
נדרשים ארבעה פרמטרים:
מפתח, אשר מפתח מפתחisbns- מערך או מחרוזת אחת מופרדת בפסיקים של מספרי ה- ISBN של הספרים שאנו רוצים את הנתונים הסטטיסטיים של הסקירהפורמט- את הפורמט של התגובה (אם כי בכל הכנות, אני לא ממש בטוח למה זה קיים, מאז התגובה היא תמיד יהיה ב JSON. תוכניות עבור יישומים עתידיים?)התקשר חזרה, את הפונקציה כי יהיה לעטוף את התגובה JSON
בואו ניקח את שני הספרים; ראש ג 'אווה ראשית, מהדורה ראשונה (ISBN: 0596009208) חלקים טובים, מהדורה ראשונה (ISBN: 0596517742) וקבלו את גרסאות הבדיקות שלהם. כתובת האתר של הבקשה היא כך:
https://www.goodreads.com/book/review_counts.json?key=apikey&isbns=0596009208,0596517742
וה responseText אחרי היופי נראה כך.
"books": "" id ":" hebn ":" 0596009208 "," isbn13 ":" 9780596009205 "," ratings_count ": 1842," reviews_count ": 3599," texthors_count ": 124," work_ratings_count " : ",", "Isbb13", "isbn13": "9780596517748", "ratings_count", "דירוגים": 393, "work_textirms_count" : "442," ", הערה:
אם אתה רוצה את הדירוג של ראשית ג 'אווה ראשית, מהדורה ראשונה הספר, זה בפנים [0]. ה דירוגים ו reviews_count המפתחות באובייקטים מייצגים את המספר הכולל של דירוגים שהועברו וסקירות שבוצעו עבור אותה מהדורה מסוימת של הספר.
באופן דומה , טקסט מייצג את סך הטקסט בלבד ביקורות של המהדורה של הספר. ואילו work_ratings_count, נות ו work_textirms_count מייצגים את סך כל הדירוגים, ביקורות וטקסט בלבד הסקירות של כל המהדורות.
אם תלחץ על פרטי דירוג של JavaScript: החלקים הטובים (מהדורה ראשונה) ב Goodreads זה יציג את זה.
תוכל להשתמש בכל פרטי הביקורת הנוספים האלה אם תרצה או רק להציג דירוג כוכבים עבור הספר באמצעות דירוג ממוצע ערך מפתח.
הערה: על פי תיעוד ה- API, “ממשק ה- API של Goodreads מעניק לך גישה מלאה לנתוני meta-Data שבבעלות Goodreads, אך הוא אינו מספק גישה מלאה לנתוני meta-data שמספקים צדדים שלישיים כגון Ingram. ייתכן שתמונות כיסוי, תיאורים ונתונים אחרים ממקורות של צד שלישי לא ייכללו, מכיוון שאין לנו רישיון להפיץ נתונים אלה באמצעות ממשק ה- API שלנו.”
לאחר שקראת את עטיפות הספר ותיאוריו, תוכל להציג את פרטי הספר במידה מסוימת.
