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