מי יכול להשתמש בו?
ליגות בתוכנית Gold שהפעילו את ה-API. כדי להפעיל אותו, עבור אל דף הבית של הניהול > API > הגדרות API (Admin Home > API > API Settings) וסמן את הפעלת JSON API (Enable JSON API). אם אחד מהם חסר, כל כתובת אינטרנט במאמרים האלה תחזיר שגיאה במקום הנתונים שלך.
מה זה?
ה-API מאפשר לאתר, לאפליקציה או לתוכנה אחרת לקרוא את לוחות המשחקים, התוצאות והטבלאות של הליגה שלך ישירות מ-LeagueRepublic. אפשר לחשוב על זה כמו על מלצר: האתר שלך מבקש משהו ("המשחקים של היום, בבקשה") ו-LeagueRepublic מחזיר את התשובה.
איך מבקשים?
נכנסים לכתובת אינטרנט, בדיוק כמו שפותחים עמוד אינטרנט. במקום עמוד יפה מקבלים בחזרה טקסט פשוט בפורמט שנקרא JSON. הקוד של מפתח האתרים שלך, או עמוד שנבנה בידי עוזר בינה מלאכותית, קורא את הטקסט הזה והופך אותו למה שתיכננת.
איך נראה JSON?
זו רשימה של תוויות וערכים, קצת כמו טופס שמולא:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
המילה שלפני הנקודתיים היא שם השדה (התווית בטופס). מה שאחריה הוא הערך (מה שנכתב בתיבה). מפרט ה-API מסביר מה כל שם שדה אומר.
מה זה מזהה (ID)?
לכל ליגה, עונה, מחלקה, קבוצה ומשחק ב-LeagueRepublic יש מספר משלו, שנקרא מזהה (ID). הוא פועל כמו מספר חבר: הוא לא משתנה לעולם, ואין שני דברים שחולקים אותו. מכניסים מזהים לכתובת האינטרנט כדי לציין איזו עונה או קבוצה אתה רוצה.
איך מוצאים את המזהים שלי?
מזהה הליגה שלך מוצג ב-דף הבית של הניהול > API > הגדרות API (Admin Home > API > API Settings).
מזהה העונה שלך: פתח את הכתובת הזו בדפדפן, כשמזהה הליגה שלך מחליף את [MY-LEAGUE-ID]. היא מציגה את העונות שלך, כל אחת עם המזהה שלה.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
מזהי מחלקות וקבוצות מופיעים ברשימות ש-API מחזיר. אם אתה משתמש באחד מהמאמרים בניית…, עוזר הבינה המלאכותית מחפש אותם בשבילך.
יש מגבלה?
כן. כל ליגה יכולה לשלוח רק מספר מסוים של בקשות בדקה, והמספר משותף לכל מה שמשתמש בנתוני הליגה שלך: האתר שלך, אפליקציות וכל דבר אחר. עמוד שנבנה היטב שומר את מה שהוא טוען במקום לבקש שוב ושוב. מפרט ה-API מציין את המגבלה המדויקת.
כמה מילים שתראה
Road – הקבוצה האורחת. LeagueRepublic אומר "road" במקום שרוב האנשים אומרים "אורחת".
Fixture – משחק, בין שכבר שוחק ובין שלא.
Fixture group – מחלקה (למשל "Premier Division"), גביע או קבוצה אחרת של משחקים.
Result – משחק שיש לו תוצאה.
null – התיבה ריקה. הליגה לא הזינה אותה, או שהיא לא רלוונטית.
true / false – כן / לא.
איפה כל הפרטים?
כל מה שמדויק, כמו כל שם שדה, המגבלה והודעות השגיאה, נמצא במפרט ה-API: