Web Services αποτελεσμάτων παιχνιδιών της ΟΠΑΠ Α.Ε.

Γενικά

Τα web services είναι μια τεχνολογία που επιτρέπει στις εφαρμογές να επικοινωνούν μεταξύ τους ανεξαρτήτως πλατφόρμας και γλώσσας προγραμματισμού. Ένα web service είναι μια διεπαφή λογισμικού (software interface) που περιλαμβάνει μια συλλογή από λειτουργίες, οι οποίες μπορούν να προσεγγιστούν από το δίκτυο μέσω πρότυπων μηνυμάτων, για να περιγράψουν μία λειτουργία προς εκτέλεση και τα δεδομένα προς ανταλλαγή με κάποια άλλη εφαρμογή.

Η ΟΠΑΠ ΑΕ παρέχει τις παρακάτω διαδικτυακές υπηρεσίες μέσω web services τύπου REST (Representational State Transfer), προκειμένου να χρησιμοποιηθούν από οποιοδήποτε ενδιαφερόμενο μέρος. Tα σχετικά δεδομένα επιστρέφονται σε μορφή JSON (JavaScript Object Notation).

Notes:

1. Στα παρακάτω URLs, οι μέθοδοι και οι τιμές παραμέτρων, διακρίνουν μεταξύ πεζών και κεφαλαίων γραμμάτων (case sensitive)
2. Το Swagger αρχείο για τα Web Services βρίσκεται στο: https://api.opap.gr/numerics/v1.0/api-swagger

 

Αριθμοπαιχνίδια: Διαγωνισμοί/ Κληρώσεις και Αποτελέσματα

Για τα παιχνίδια POWERSPIN, ΤΖΟΚΕΡ, KINO, ΛΟΤΤΟ, ΠΡΟΤΟ, SUPER3 και EXTRA5 παρέχονται οι παρακάτω μέθοδοι:

Περιγραφή Κλήση
Επιστρέφει το DrawID, τα στοιχεία, και τα αποτελέσματα της πιο πρόσφατης κλήρωσης/ διαγωνισμού του παιχνιδιού https://api.opap.gr/draws/v3.0/{gameId}/last-result-and-active
Επιστρέφει κληρώσεις /διαγωνισμούς του παιχνιδιού για συγκεκριμένο εύρος ημερομηνιών https://api.opap.gr/draws/v3.0/{gameId}/draw-date/{fromDate}/{toDate}
Επιστρέφει τους τελευταίους διαγωνισμούς/ κληρώσεις για το παιχνίδι https://api.opap.gr/draws/v3.0/{gameId}/last/{limit}
Επιστρέφει τα DrawIds του παιχνιδιού για συγκεκριμένο εύρος ημερομηνιών https://api.opap.gr/draws/v3.0/{gameId}/draw-date/{fromDate}/{toDate}/draw-id
Επιστρέφει τα στοιχεία και τα αποτελέσματα κλήρωσης ή διαγωνισμού παιχνιδιού για συγκεκριμένο DrawId https://api.opap.gr/draws/v3.0/{gameId}/{drawId}
Επιστρέφει τα αποτελέσματα/την κλήρωση του  παιχνιδιού για συγκεκριμένο εύρος Draw Ids https://api.opap.gr/draws/v3.0/{gameId}/draw-id/{fromDrawId}/{toDrawId}
Επιστρέφει την επερχόμενη κλήρωση του παιχνιδιού https://api.opap.gr/draws/v3.0/{gameId}/upcoming/1
Επιστρέφει τον ενεργό διαγωνισμό του παιχνιδιού https://api.opap.gr/draws/v3.0/{gameId}/active
Επιστρέφει στατιστικά στοιχεία του παιχνιδιού (για όλα τα παιχνίδια εκτός από το ΚΙΝΟ) https://api.opap.gr/games/v1.0/{gameId}/statistics
Επιστρέφει στατιστικά στοιχεία του παιχνιδιού για το ΚΙΝΟ https://api.opap.gr/games/v1.0/1100/statistics?drawRange=1801

 

Σημειώσεις

{gameId} -      Παιχνίδι

1100 Kino
1110 Powerspin
2100 Super3
2101 Proto
5103 Lotto
5104 Tzoker
5106 Extra5
5149 Eurojackpot

 {fromDate} / {toDate} : Μορφή ημερομηνίας: yyyy-mm-dd (πχ 2018-06-01 για την 1η Ιουνίου, 2018)
{limit} : Αριθμός των τελευταίων διαγωνισμών/ κληρώσεων για τους οποίους θα επιστραφούν δεδομένα
{drawId} : ID διαγωνισμού/κλήρωσης
{fromDrawId} / {toDrawId} : από – έως   εύρος DrawIDs  κληρώσεων/ διαγωνισμών για τους οποίους θα επιστραφούν δεδομένα

 

ΠΡΟΠΟ /ΠΡΟΠΟΓΚΟΛ Πρόγραμμα, Κληρώσεις και Αποτελέσματα

Για τα παιχνίδια ΠΡΟΠΟ και ΠΡΟΠΟΓΚΟΛ παρέχονται οι παρακάτω μέθοδοι:

Περιγραφή Κλήση
Επιστρέφει τον τελευταίο διαγωνισμό/κλήρωση με αποτελέσματα ή χωρίς, καθώς και τον τελευταίο ενεργό διαγωνισμό https://api.opap.gr/draws/v3.0/{gameId}/last-result-and-active
Επιστρέφει κληρώσεις ή διαγωνισμούς του παιχνιδιού για συγκεκριμένο εύρος ημερομηνιών https://api.opap.gr/draws/v3.0/{gameId}/draw-date/{fromDate}/{toDate}
Επιστρέφει τελευταίους διαγωνισμούς/ κληρώσεις για το παιχνίδι https://api.opap.gr/draws/v3.0/{gameId}/last/{limit}
Επιστρέφει τα Drawids του παιχνιδιού για συγκεκριμένο εύρος ημερομηνιών https://api.opap.gr/draws/v3.0/{gameId}/draw-date/{fromDate}/{toDate}/draw-id
Επιστρέφει δεδομένα του διαγωνισμού για συγκεκριμένο visualDraw https://api.opap.gr/draws/v3.0/{gameId}/visual-draw/{visualDraw}
Επιστρέφει τα αποτελέσματα/την κλήρωση του  παιχνιδιού για συγκεκριμένο εύρος Draw Ids https://api.opap.gr/draws/v3.0/{gameId}/draw-id/{fromDrawId}/{toDrawId}
Επιστρέφει την επερχόμενη κλήρωση του παιχνιδιού https://api.opap.gr/draws/v3.0/{gameId}/upcoming/1
Επιστρέφει τον ενεργό διαγωνισμό του παιχνιδιού https://api.opap.gr/draws/v3.0/{gameId}/active
Επιστρέφει το πρόγραμμα ενός διαγωνισμού https://api.opap.gr/program/v1.0/{gameId}/visual-draw/{visualDrawId}

 

Σημειώσεις

{gameId} -      Παιχνίδι

3100 ΠΡΟΠΟ (Κυριακή)
3101 ΠΡΟΠΟ (Τετάρτη)
3102 ΠΡΟΠΟ (Σάββατο)
5105 ΠΡΟΠΟΓΚΟΛ		 {fromDate} / {toDate} : Μορφή ημερομηνίας: yyyy-mm-dd (πχ 2018-06-01 για την 1η Ιουνίου του 2018)
{limit} : Αριθμός των τελευταίων διαγωνισμών/ κληρώσεων για τους οποίους θα επιστραφούν δεδομένα
{visualDraw} : το visualDraw του παιχνιδιού είναι της μορφής <YYYY><Competition> (πχ. 20185 για τον 5ο διαγωνισμό του έτους 2018)

Παράδειγμα:

1. Πρόγραμμα για το ΠΡΟΠΟ Κυριακής:

  • Κλήση /draws/v3.0/3100/active προκειμένου να αποκτηθούν τα δεδομένα του ενεργού διαγωνισμού/κλήρωσης του ΠΡΟΠΟ της Κυριακής
  • Υποθέτοντας ότι το Visual Draw είναι 201889, καλώντας /program/v1.0/3100/visual-draw/201889 τα στοιχεία του διαγωνισμού γίνονται διαθέσιμα (ονόματα ομάδων, ημερομηνίες, αξιολογήσεις).

2. Αποτελέσματα του ΠΡΟΠΟ της Κυριακής:

  • Καλώντας την / draws/v3.0/3100/last-result-and-active, λαμβάνεται ο ενεργός διαγωνισμός/ κλήρωση του ΠΡΟΠΟ της Κυριακής καθώς και ο τελευταίος διαγωνισμός με αποτελέσματα
  • Υποθέτοντας ότι το drawID του ενεργού δελτίου είναι 963, με την κλήση:
    • /draws/v3.0/3100/draw-id/962 (active drawid -1) λαμβάνεται το visual draw
    • /program/v1.0/3100/962(active drawid -1) λαμβάνεται το πλήρες πρόγραμμα (ομάδες, ημερομηνίες, αξιολόγηση) μαζί με τα αποτελέσματα.
    Εάν δεν επιστρέφεται ενεργό δελτίο από την / draws/v3.0/3100/last-result-and-active τότε για  την κλήση των παραπάνω κλήσεων χρησιμοποιούμε το drawid του τελευταίου δελτίου με αποτελέσματα

3. Προηγούμενα προγράμματα ΠΡΟΠΟ Κυριακής:

  • Καλώντας την /program/v1.0/3100/draw-date/2018-01-01/2108-12-31 λαμβάνεται το Visual Draw και οι αντίστοιχες ημερομηνίες έναρξης/ λήξης για κάθε Διαγωνισμό ΠΡΟΠΟ Κυριακής του 2018
  • Υποθέτοντας ότι το Visual Draw 201888 είναι μέρος της απάντησης, καλώντας /program/v1.0/3100/visual-draw/201888 επιστρέφεται το πλήρες πρόγραμμα (ονόματα ομάδων, ημερομηνίες αγώνων, αξιολογήσεις) μαζί με τα αποτελέσματα