Ποιος μπορεί να το χρησιμοποιήσει;
Πρωταθλήματα με το πρόγραμμα Gold που έχουν ενεργοποιήσει το API. Για να το ενεργοποιήσετε, μεταβείτε στο Αρχική σελίδα διαχειριστή > API > Ρυθμίσεις API και επιλέξτε Ενεργοποίηση JSON API. Αν λείπει οποιοδήποτε από τα δύο, κάθε διεύθυνση ιστού σε αυτά τα άρθρα επιστρέφει σφάλμα αντί για τα δεδομένα σας.
Τι είναι;
Το API επιτρέπει σε έναν άλλο ιστότοπο, εφαρμογή ή πρόγραμμα να διαβάζει τους αγώνες, τα αποτελέσματα και τους πίνακες βαθμολογίας του πρωταθλήματός σας απευθείας από τη LeagueRepublic. Σκεφτείτε το σαν έναν σερβιτόρο: ο ιστότοπός σας ζητά κάτι («οι αποψινοί αγώνες, παρακαλώ») και η LeagueRepublic φέρνει την απάντηση.
Πώς ζητάτε κάτι;
Επισκέπτεστε μια διεύθυνση ιστού, όπως ακριβώς ανοίγετε μια ιστοσελίδα. Αντί για μια όμορφη σελίδα, παίρνετε απλό κείμενο σε μια μορφή που λέγεται JSON. Ο κώδικας του προγραμματιστή ιστού σας ή μια σελίδα που έφτιαξε ένας βοηθός AI διαβάζει αυτό το κείμενο και το μετατρέπει σε ό,τι σχεδιάσετε.
Πώς μοιάζει το JSON;
Είναι μια λίστα από ετικέτες και τιμές, κάτι σαν μια φόρμα που έχει συμπληρωθεί:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Η λέξη πριν από την άνω και κάτω τελεία είναι το όνομα πεδίου (η ετικέτα στη φόρμα). Αυτό που ακολουθεί είναι η τιμή (αυτό που γράφτηκε στο κουτάκι). Η προδιαγραφή του API εξηγεί τι σημαίνει κάθε όνομα πεδίου.
Τι είναι ένα ID;
Κάθε πρωτάθλημα, σεζόν, κατηγορία, ομάδα και αγώνας στη LeagueRepublic έχει τον δικό του αριθμό, που ονομάζεται ID. Λειτουργεί σαν αριθμός μέλους: δεν αλλάζει ποτέ και δύο πράγματα δεν έχουν τον ίδιο. Βάζετε τα ID στη διεύθυνση ιστού για να πείτε ποια σεζόν ή ποια ομάδα θέλετε.
Πώς βρίσκω τα ID μου;
Το ID του πρωταθλήματός σας εμφανίζεται στο Αρχική σελίδα διαχειριστή > API > Ρυθμίσεις API.
Το ID της σεζόν σας: ανοίξτε αυτή τη διεύθυνση στο πρόγραμμα περιήγησής σας, βάζοντας το ID του πρωταθλήματός σας στη θέση του [MY-LEAGUE-ID]. Εμφανίζει τις σεζόν σας, την καθεμία με το ID της.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Τα ID κατηγοριών και ομάδων εμφανίζονται στις λίστες που επιστρέφει το API. Αν χρησιμοποιήσετε ένα από τα άρθρα Δημιουργήστε…, ο βοηθός AI τα βρίσκει για εσάς.
Υπάρχει όριο;
Ναι. Κάθε πρωτάθλημα μπορεί να κάνει μόνο έναν συγκεκριμένο αριθμό αιτημάτων το λεπτό, τον οποίο μοιράζονται όλα όσα χρησιμοποιούν τα δεδομένα του πρωταθλήματός σας: ο ιστότοπός σας, οι εφαρμογές και οτιδήποτε άλλο. Μια καλοφτιαγμένη σελίδα αποθηκεύει ό,τι φορτώνει αντί να ρωτά ξανά και ξανά. Η προδιαγραφή του API αναφέρει το ακριβές όριο.
Μερικές λέξεις που θα συναντήσετε
Road – η φιλοξενούμενη ομάδα. Η LeagueRepublic λέει «road» εκεί που οι περισσότεροι λένε «εκτός έδρας» («away»).
Fixture – ένας αγώνας, είτε έχει διεξαχθεί είτε όχι.
Fixture group – μια κατηγορία (όπως η «Premier Division»), ένα κύπελλο ή άλλη ομάδα αγώνων.
Result – ένας αγώνας που έχει σκορ.
null – το κουτάκι είναι κενό. Το πρωτάθλημα δεν το συμπλήρωσε ή δεν ισχύει.
true / false – ναι / όχι.
Πού βρίσκονται όλες οι λεπτομέρειες;
Όλες οι ακριβείς πληροφορίες, όπως κάθε όνομα πεδίου, το όριο και τα μηνύματα σφάλματος, βρίσκονται στην προδιαγραφή του API: