Ποιος μπορεί να το χρησιμοποιήσει;
Τα πρωταθλήματα με το πρόγραμμα «Χρυσό» που έχουν ενεργοποιήσει το 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 του πρωταθλήματός σας στη θέση του [ID-ΤΟΥ-ΠΡΩΤΑΘΛΗΜΑΤΟΣ-ΜΟΥ]. Εμφανίζει τις σεζόν σας, την καθεμία με το ID της.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-ΤΟΥ-ΠΡΩΤΑΘΛΗΜΑΤΟΣ-ΜΟΥ].json
Τα ID κατηγοριών και ομάδων εμφανίζονται στις λίστες που επιστρέφει το API. Αν χρησιμοποιήσετε ένα από τα άρθρα Δημιουργήστε…, ο βοηθός AI τα βρίσκει για εσάς.
Υπάρχει όριο;
Ναι. Κάθε πρωτάθλημα μπορεί να κάνει μόνο έναν συγκεκριμένο αριθμό αιτημάτων το λεπτό, τον οποίο μοιράζονται όλα όσα χρησιμοποιούν τα δεδομένα του πρωταθλήματός σας: ο ιστότοπός σας, οι εφαρμογές και οτιδήποτε άλλο. Μια καλοφτιαγμένη σελίδα αποθηκεύει ό,τι φορτώνει αντί να ζητά τα ίδια ξανά και ξανά. Η προδιαγραφή του API αναφέρει το ακριβές όριο.
Μερικές λέξεις που θα συναντήσετε
Road – η φιλοξενούμενη ομάδα. Η LeagueRepublic λέει "road" εκεί που οι περισσότεροι λένε «εκτός έδρας» ("away").
Fixture – ένας αγώνας, είτε έχει διεξαχθεί είτε όχι.
Fixture group – μια κατηγορία (όπως η «Α΄ Κατηγορία»), ένα κύπελλο ή άλλη ομάδα αγώνων.
Result – ένας αγώνας που έχει σκορ.
null – το κουτάκι είναι κενό. Το πρωτάθλημα δεν το συμπλήρωσε ή δεν ισχύει.
true / false – ναι / όχι.
Πού βρίσκονται όλες οι λεπτομέρειες;
Όλες οι ακριβείς πληροφορίες, όπως κάθε όνομα πεδίου, το όριο και τα μηνύματα σφάλματος, βρίσκονται στην προδιαγραφή του API: