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

 

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

  • Για τα παιχνίδια KINO, ΛΟΤΤΟ, ΤΖΟΚΕΡ, ΠΡΟΤΟ, SUPER3 and 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?dayRange=10

 

Σημειώσεις

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

2100 Super3

5106 Extra5

2101 Proto

5103 Lotto

1100 Kino

5104 Joker

{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}

Επιστρέφει την επερχόμενη κλήρωση του παιχνιδιού

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)

 

Παράδειγμα:

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

  • Προηγούμενα προγράμματα ΠΡΟΠΟ Κυριακής:
    • Καλώντας την /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 επιστρέφεται το πλήρες πρόγραμμα (ονόματα ομάδων, ημερομηνίες αγώνων, αξιολογήσεις) μαζί με τα αποτελέσματα