API | vaseis-app

☰

API του vaseis-app

Το API του vaseis-app χρησιμοποιεί απλά URIs για την ανάκτηση πληροφοριών. Επιστρέφει δεδομένα σε μορφή JSON. Παρακάτω αναλύονται οι τρόποι ανάκτησης αυτών των δεδομένων, καθώς και χρήσιμες πληροφορίες.

Αρχικό URL

https://vaseis.iee.ihu.gr/api/index.php

Changelog

14/06/2021

Προσθήκη των νέων endpoints της έκδοσης 1.0 του API.
Προσθήκη των πεδίων για τις ιστοσελίδες, λόγοτυπα, αριθμούς τηλεφώνου και email των τμημάτων και πανεπιστημίων

Μελλοντικά updates

Διόρθωση γνωστών σφαλμάτων
Προσθήκη δυνατότητας σελιδοποίησης του API, για την αποφυγή μεταφοράς μεγάλου όγκου δεδομένων.

Επικοινωνία

Για απορίες, προτάσεις και ενημέρωση για προβλήματα επικοινωνήστε στο [info(at)vioannidis(dot)com] (Βασίλης Ιωαννίδης).

Ταυτοποίηση

Η απαίτηση ταυτοποίησης θα προστεθεί μεταγενέστερα.

Χρήση του API

Η χρήση του API είναι ελεύθερη και δωρεάν. Συστήνεται η αναφορά χρήσης του vaseis-app API στις εφαρμογές που αναπτύσσονται.

Το API προσφέρεται με άδεια χρήσης GPLv3, ο πηγαίος κώδικας είναι διαθέσιμος εδώ. Περισσότερες πληροφορίες για την άδεια χρήσης GPLv3 είναι διαθέσιμες εδώ.

Endpoints

Έκδοση 1.0

Η έκδοση 1.0 του API, προσφέρει ανανεωμένα endpoints για τις βάσεις εισαγωγής και τα στατιστικά προτιμήσεων. Τα νεα endpoints προσφέρουν περισσότερο οργανωμένη δομή που έχει ως αποτέλεσμα τη μεταφορά μικρότερου όγκου δεδομένων

Βάσεις εισαγωγής ανά τμήμα

GET v1.0/bases/department/{dept_id}

Επιστρέφει τις βάσεις εισαγωγής για όλα τα διαθέσιμα έτη για το επιλεγμένο τμήμα

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/v1.0/bases/department/1625?type=gel-ime-gen

Παράδειγμα απάντησης

[
  {
    "code": 1625,
    "deptName": "ΜΗΧΑΝΙΚΩΝ ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΗΛΕΚΤΡΟΝΙΚΩΝ ΣΥΣΤΗΜΑΤΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
    "deptLogoURL": null,
    "websiteURL": "www.iee.ihu.gr",
    "phone": "2310 013621",
    "email": "info@iee.ihu.gr",
    "uniTitle": "Διεθνές Πανεπιστήμιο της Ελλάδος",
    "uniTitleShort": "ΔΙ.ΠΑ.Ε.",
    "uniLogoURL": "https:\/\/vaseis.iee.ihu.gr\/logos\/university\/dipae.png",
    "bases": [
      {
        "examType": "ΓΕΛ ΗΜΕΡΗΣΙΑ",
        "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
        "positions": 160,
        "baseFirst": 16435,
        "baseLast": 12806,
        "year": 2019,
        "field": ""
      },
      {
        "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ",
        "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
        "positions": 145,
        "baseFirst": 16125,
        "baseLast": 13325,
        "year": 2020,
        "field": "2\/4"
      }
    ]
  }
]

Βάσεις εισαγωγής πολλών τμημάτων

GET v1.0/bases/?departments={dept_id1,dept_id2,...}

Επιστρέφει τις βάσεις εισαγωγής για όλα τα διαθέσιμα έτη για τα τμήματα που δίνονται διαχωριζόμενα από κόμμα

Βάσεις εισαγωγής πολλών τμημάτων ανά έτος

GET v1.0/bases/{year}/departments=?{dept_id1,dept_id2,...}

Επιστρέφει τις βάσεις εισαγωγής για το επιλεγμένο έτος και για τα τμήματα που δίνονται διαχωριζόμενα από κόμμα

Στατιστικά προτιμήσεων ανά τμήμα

GET v1.0/statistics/department/{dept_id}

Επιστρέφει τα στατιστικά προτιμήσεων για όλα τα διαθέσιμα έτη για το επιλεγμένο τμήμα

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/v1.0/statistics/department/1625?type=gel-gen

Παράδειγμα απάντησης

[
  {
    "code": 1625,
    "statistics": [
      {
        "year": 2019,
        "examType": "ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ",
        "totalSuccessful": null,
        "totalCandidates": null,
        "candidatePreferences": {
          "first": "159",
          "second": "212",
          "third": "238",
          "other": "9549"
        },
        "successfulPreferences": {
          "first": "15",
          "second": "20",
          "third": "24",
          "fourth": "65",
          "fifth": "3",
          "sixth": "8",
          "other": "28"
        }
      },
      {
        "year": 2020,
        "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ",
        "totalSuccessful": null,
        "totalCandidates": null,
        "candidatePreferences": {
          "first": "150",
          "second": "165",
          "third": "193",
          "other": "5798"
        },
        "successfulPreferences": {
          "first": "18",
          "second": "16",
          "third": "20",
          "fourth": "54",
          "fifth": "11",
          "sixth": "9",
          "other": "19"
        }
      }
    ]
  }
]

Κλασσικά endpoints

Πανεπιστήμια

Το API προσφέρει τη δυνατότητα ανάκτησης Πανεπιστημίων, ΤΕΙ και λοιπών ανώτατων ιδρυμάτων. Είτε ως σύνολο είτε, μέσω αναζήτησης με συγκεκριμένα κριτήρια.

Σύνολο Πανεπιστημίων

GET /universities

Επιστρέφει το σύνολο των πανεπιστημίων

Μέρος Τυπικής Απάντησης

{
  "records": [
	{
      "id": 19595,
      "title": "ΔΙ.ΠΑ.Ε.",
      "full-title": "Διεθνές Πανεπιστήμιο της Ελλάδος"
    },
    {
      "id": 96118,
      "title": "ΔΠΘ",
      "full-title": "Δημοκρίτειο Πανεπιστήμιο Θράκης"
    }
]
}

Αναζήτηση Πανεπιστημίων

GET /universities/{uni_id}

Επιστρέφει το Πανεπιστήμιο που αντιστοιχεί στο id που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/universities/19595

Παράδειγμα Απάντησης

{
  "id": "19595",
  "title": "ΑΠΘ",
  "full-title": "Αριστοτέλειο Πανεπιστήμιο Θεσσαλονίκης"
}

Βάσεις

Οι βάσεις των πανελλαδικών μπορούν να ανακτηθούν ως σύνολο ανά έτος ή το ιστορικό ενός τμήματος. Ακόμα μπορεί να ζητηθούν οι βάσεις των τμημάτων ενός Πανεπιστήμιου για κάποιο έτος.

Φίλτρα

Με τη χρήση φίλτρων δίνεται η δυνατότητα ανάκτησης βάσεων με βάση συγκεκριμένα κριτήρια.

type=gel-ime-gen
Επιστρέφει τις βάσεις που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 90% ημερήσιων ΓΕΛ
type=epal-ime-gen
Επιστρέφει τις βάσεις που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 90% ημερήσιων ΕΠΑΛ.
type=gel-ime-ten
Επιστρέφει τις βάσεις που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 10% ημερήσιων ΓΕΛ
type=epal-ime-ten
Επιστρέφει τις βάσεις που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 10% ημερήσιων ΕΠΑΛ
details=full
Με αυτό το φίλτρο για κάθε βάση επιστρέφεται και το όνομα του πανεπιστημίου στο οποίο ανήκει το κάθε τμήμα.

Παράδειγμα Ερωτήματος

vaseis.iee.ihu.gr/api/index.php/bases/department/1625?type=gel-ime-gen

Παράδειγμα Απάντησης

{
  "records": [
    {
      "code": 1625,
      "examType": "ΓΕΛ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
      "positions": 160,
      "baseFirst": 16435,
      "baseLast": 12806,
      "year": 2019
    },
    {
      "code": 1625,
      "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 145,
      "baseFirst": 16125,
      "baseLast": 13325,
      "year": 2020
    }
  ]
}

Αναζήτηση Βάσεων ανά έτος

GET /bases/{year}

Επιστρέφει το σύνολο των βάσεων για το έτος που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/2019

Μέρος Απάντησης

{"records": [
{
      "code": 1625,
      "examType": "ΓΕΛ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
      "positions": 160,
      "baseFirst": 16435,
      "baseLast": 12806,
      "year": 2019
    },
    {
      "code": 1625,
      "examType": "ΕΠΑΛ ΕΣΠΕΡΙΝΑ",
      "specialCat": "ΕΠΑΛ ΓΕΝΙΚΗ ΣΕΙΡΑ ΕΣΠ.",
      "positions": 2,
      "baseFirst": 6730,
      "baseLast": 6275,
      "year": 2019
    }
}
]}

Αναζήτηση Βάσεων ανά τμήμα

GET /bases/department/{dept_id}

Επιστρέφει το σύνολο των βάσεων για το τμήμα που αντιστοιχεί στο id που δίνεται.

Φίλτρα

Εκτός από τα γενικά φίλτρα των βάσεων, στην αναζήτηση ανά τμήμα μπορεί να εφαρμοστει και το παρακάτω:

details=full

Με το φίλτρο details εκτός από τις ήδη υπάρχουσες πληροφορίες, στην απάντηση περιλαμβάνεται το όνομα του τμήματος και το όνομα του πανεπιστημίου στο οποίο ανήκει.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/department/1625?type=gel-ime-gen&details=full

Μέρος Απάντησης

{
  "records": [
    {
      "code": 1625,
      "examType": "ΓΕΛ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
      "positions": 160,
      "baseFirst": 16435,
      "baseLast": 12806,
      "year": 2019,
      "deptName": "ΜΗΧΑΝΙΚΩΝ ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΗΛΕΚΤΡΟΝΙΚΩΝ ΣΥΣΤΗΜΑΤΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
      "uniTitle": "Διεθνές Πανεπιστήμιο της Ελλάδος"
    },
    {
      "code": 1625,
      "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 145,
      "baseFirst": 16125,
      "baseLast": 13325,
      "year": 2020,
      "deptName": "ΜΗΧΑΝΙΚΩΝ ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΗΛΕΚΤΡΟΝΙΚΩΝ ΣΥΣΤΗΜΑΤΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
      "uniTitle": "Διεθνές Πανεπιστήμιο της Ελλάδος"
    }
  ]
}

Αναζήτηση Βάσεων ανά έτος και τμήμα

GET /bases/{year}/department/{dept_id}

Επιστρέφει το σύνολο των βάσεων για το έτος που δίνεται και για το τμήμα που αντιστοιχεί στο id που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/2020/department/1625

Μέρος Απάντησης

{"records": [
{
      "code": 1625,
      "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 145,
      "baseFirst": 16125,
      "baseLast": 13325,
      "year": 2020
    },
    {
      "code": 1625,
      "examType": "ΓΕΛ ΠΑΛΑΙΟ ΗΜΕΡΗΣΙΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΠΑΛΑΙΟ)",
      "positions": 15,
      "baseFirst": 12774,
      "baseLast": 8569,
      "year": 2020
    }
}
]}

Αναζήτηση βάσεων με παραμέτρους

Το API σας δίνει τη δυνατότητα να αναζητήσετε βάσεις δίνοντας ως παραμέτρους την μέγιστη/ελάχιστη βάση εισαγωγής, ένα ερώτημα αναζήτησης (π.χ. πληροφορική) ή/και το έτος που επιθυμείτε.

Στα παρακάτω είναι υποχρεωτική η χρήση του φίλτρου details=full.

Αναζήτηση με παραμέτρους: βάση εισαγωγής, τμήμα, έτος

GET/bases/search/?base={base}&department={search_query}&year={year}&=details=full

Επιστρέφει όλες τις βάσεις που αντιστοιχούν στο έτος και μικρότερες απο την τιμή της βάσης που δόθηκε, καθώς και και στο ερώτημα αναζήτησης.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/search/?base=15000&department=πληροφορική&year=2020&details=full&type=gel-ime-gen

Μέρος Απάντησης

{
      "code": 215,
      "examType": "ΠΑΝ. ΠΑΤΡΩΝ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 167,
      "baseFirst": 18700,
      "baseLast": 13575,
      "year": 2020,
      "deptName": "ΜΗΧΑΝΙΚΩΝ ΗΛΕΚΤΡΟΝΙΚΩΝ ΥΠΟΛΟΓΙΣΤΩΝ ΚΑΙ ΠΛΗΡΟΦΟΡΙΚΗΣ (ΠΑΤΡΑ)",
      "uniTitle": "Πανεπιστήμιο Πατρών"
    },
    {
      "code": 340,
      "examType": "ΠΑΝ. ΙΩΑΝΝΙΝΩΝ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 175,
      "baseFirst": 16850,
      "baseLast": 12425,
      "year": 2020,
      "deptName": "ΜΗΧΑΝΙΚΩΝ ΗΛΕΚΤΡΟΝΙΚΩΝ ΥΠΟΛΟΓΙΣΤΩΝ ΚΑΙ ΠΛΗΡΟΦΟΡΙΚΗΣ (ΙΩΑΝΝΙΝΑ)",
      "uniTitle": "Πανεπιστήμιο Ιωαννίνων"
    }

Αναζήτηση με παραμέτρους: βάση εισαγωγής, τμήμα

GET/bases/search/?base={base}&department={search_query}&=details=full

Επιστρέφει όλες τις βάσεις που αντιστοιχούν σε βάσεις εισαγωγής μικρότερες από την τιμή της βάσης που δόθηκε, καθώς και και στο ερώτημα αναζήτησης.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/search/?base=18500&department=ιατρική&details=full&type=gel-ime-gen

Μέρος Απάντησης

{
      "code": 297,
      "examType": "ΑΠΘ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ. (ΝΕΟ)",
      "positions": 119,
      "baseFirst": 19650,
      "baseLast": 18075,
      "year": 2020,
      "deptName": "ΙΑΤΡΙΚΗΣ (ΘΕΣΣΑΛΟΝΙΚΗ)",
      "uniTitle": "Αριστοτέλειο Πανεπιστήμιο Θεσσαλονίκης"
    },
    {
      "code": 299,
      "examType": "ΠΑΝ. ΠΑΤΡΩΝ",
      "specialCat": "90% ΓΕΝΙΚΗ  ΣΕΙΡΑ",
      "positions": 135,
      "baseFirst": 19481,
      "baseLast": 18449,
      "year": 2013,
      "deptName": "ΙΑΤΡΙΚΗΣ (ΠΑΤΡΑ)",
      "uniTitle": "Πανεπιστήμιο Πατρών"
    }

Αναζήτηση με παραμέτρους: βάση εισαγωγής, έτος

GET/bases/search/?base={base}&year={year}&=details=full

Επιστρέφει όλες τις βάσεις που αντιστοιχούν σε βάσεις εισαγωγής μικρότερες από την τιμή της βάσης που δόθηκε, καθώς και και στο έτος που δόθηκε.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/search/?base=12000&year=2018&details=full&type=gel-ime-gen

Μέρος Απάντησης

{
      "code": 101,
      "examType": "ΕΚΠΑ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
      "positions": 215,
      "baseFirst": 15279,
      "baseLast": 10675,
      "year": 2018,
      "deptName": "ΘΕΟΛΟΓΙΑΣ (ΑΘΗΝΑ)",
      "uniTitle": "Εθνικό και Καποδιστριακό Πανεπιστήμιο Αθηνών"
    },
    {
      "code": 102,
      "examType": "ΠΑΝ. ΠΑΤΡΩΝ",
      "specialCat": "ΓΕΛ ΓΕΝIKH ΣΕΙΡΑ ΗΜ.",
      "positions": 162,
      "baseFirst": 18223,
      "baseLast": 11989,
      "year": 2018,
      "deptName": "ΦΙΛΟΣΟΦΙΑΣ (ΠΑΤΡΑ)",
      "uniTitle": "Πανεπιστήμιο Πατρών"
    }

Ελάχιστο και Μέγιστο Έτος Δεδομένων Βάσεων

GET/bases/?year=min

GET/bases/?year=max

Μπορείτε να αναζητήσετε το ελάχιστο και το μέγιστο έτος των δεδομένων που προσφέρονται για τις βάσεις με τα παρακάτω φίλτρα:

year=min
year=max

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/bases/?year=min

Τυπική Απάντηση

{
  "minYear": 2013
}

Τμήματα

Τα Τμήματα των ανώτατων εκπαιδευτικών ιδρυμάτων μπορούν να ανακτηθούν ως σύνολο, με αναζήτηση του id τους. Επίσης δίνεται η δυνατότητα ανάκτησης Τμημάτων ανά Πανεπιστήμιο.

Σύνολο Τμημάτων

GET /departments

Επιστρέφει το σύνολο των τμημάτων από όλα τα ιδρύματα.

Για το σύνολο των τμημάτων προσφέρεται και το φίλτρο:

details=full

Αυτό το φίλτρο προσθέτει στα αποτελέσματα τον σύντομο και ολόκληρο των τίτλο του πανεπιστήμιου που ανήκει κάθε τμήμα.

Παράδειγμα Ερώτησης

https://vaseis.iee.ihu.gr/api/index.php/departments/

Μέρος Τυπικής Απάντησης

[
{
  "code": 97,
  "name": "ΟΙΚΟΝΟΜΙΚΩΝ ΕΠΙΣΤΗΜΩΝ (ΚΟΜΟΤΗΝΗ)",
  "uni-id": 96118
},
{
  "code": 98,
  "name": "ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΤΗΛΕΠΙΚΟΙΝΩΝΙΩΝ (ΤΡΙΠΟΛΗ)",
  "uni-id": 96409
},
{
  "code": 99,
  "name": "ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΤΗΛΕΠΙΚΟΙΝΩΝΙΩΝ (ΛΑΜΙΑ)",
  "uni-id": 96283
}
]

Αναζήτηση Τμήματος

GET /departments/{dept_id}

Επιστρέφει το Τμήμα που αντιστοιχεί στο id που δόθηκε.

Παράδειγμα Ερώτησης

https://vaseis.iee.ihu.gr/api/index.php/departments/1625

Παράδειγμα Απάντησης

{
  "code": "1625",
  "title": "ΜΗΧΑΝΙΚΩΝ ΠΛΗΡΟΦΟΡΙΚΗΣ ΚΑΙ ΗΛΕΚΤΡΟΝΙΚΩΝ ΣΥΣΤΗΜΑΤΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
  "uni-id": 19595
}

Αναζήτηση Τμημάτων ανά Πανεπιστήμιο

GET /departments/university/{uni_id}

Επιστρέφει το σύνολο των Τμημάτων που ανήκουν στο Πανεπιστήμιο που αντιστοιχεί στο id.

Παράδειγμα Ερώτησης

https://vaseis.iee.ihu.gr/api/index.php/departments/university/19595

Μέρος Απάντησης

[
{
    "code": 233,
    "name": "ΑΡΧΙΤΕΚΤΟΝΩΝ ΜΗΧΑΝΙΚΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
    "uni-id": 96025
  },
  {
    "code": 237,
    "name": "ΧΗΜΙΚΩΝ ΜΗΧΑΝΙΚΩΝ (ΘΕΣΣΑΛΟΝΙΚΗ)",
    "uni-id": 96025
  }
]

Τύποι Εξετάσεων

GET /examtypes

Οι διαφορετικοί τύποι εξετάσεων μπορούν να ανακτηθούν ως σύνολο.

Μέρος Τυπικής Απάντησης

[
  {
    "title": "10% ΕΠΑΛΑ 2016",
    "description": null
  },
  {
    "title": "ΓΕΛ ΕΣΠΕΡΙΝΑ",
    "description": null
  },
  {
    "title": "ΓΕΛ ΗΜΕΡΗΣΙΑ",
    "description": null
  }
]

Ειδικές Κατηγορίες

GET /special-categories

Οι διαφορετικές Ειδικές Κατηγορίες μπορούν να ανακτηθούν ως σύνολο.

Μέρος Τυπικής Απάντησης

[
  {
    "code": 101,
    "title": "90% ΕΙΔ.ΠΕΡ. ΤΡΙΤΕΚΝΟΙ (ΕΣΠ)"
  },
  {
    "code": 817,
    "title": "10% ΑΕΝ ΕΙΔ.ΚΑΤ.ΠΟΛΥΤΕΚΝΟΙ ΑΠΟΦ. 2014"
  }
]

Στατιστικά

Το API διαθέτει ένα σύνολο δυνατοτήτων ανάκτησης στατιστικών με βάση το έτος, το τμήμα, το πανεπιστήμιο και την κατηγορία.

Αναζήτηση Στατιστικών ανά έτος

GET/statistics/{year}

Επιστρέφει το σύνολο των στατιστικών για τό έτος που δόθηκε.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/2020

Μέρος Απάντησης

[
  {
    "code": 97,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 0,
    "preference": 1,
    "count": 3,
    "year": 2020
  },
  {
    "code": 97,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 0,
    "preference": 2,
    "count": 1,
    "year": 2020
  }
]

Αναζήτηση Στατιστικών ανά τμήμα

GET/statistics/department/{dept_id}

Επιστρέφει το σύνολο το στατιστικών για το τμήμα που δόθηκε.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/department/1625

Μέρος Απάντησης

[
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 0,
    "preference": 1,
    "count": 5,
    "year": 2020
  },
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 0,
    "preference": 2,
    "count": 3,
    "year": 2020
  }
]

Αναζήτηση Στατιστικών ανά πανεπιστήμιο

GET/statistics/university/{uni_id}

Επιστρέφει το σύνολο των στατιστικών για το πανεπιστήμιο που αντιστοιχεί στο id που δόθηκε.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/university/19595

Μέρος Απάντησης

[
  [
    {
      "code": 103,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 1,
      "count": 2,
      "year": 2020
    },
    {
      "code": 103,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 2,
      "count": 7,
      "year": 2020
    }
  ]
]

Αναζήτηση Στατιστικών ανά έτος και κατηγορία

GET/statistics/{year}/category/{category}

Επιστρέφει το σύνολο το στατιστικών που αντιστοιχούν στό έτος και την κατηγορία που δόθηκε.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/2020/category/0

Μέρος Απάντησης

[
{
    "code": 270,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2019",
    "category": 0,
    "preference": 7,
    "count": 417,
    "year": 2020
  },
  {
    "code": 270,
    "examType": "ΓΕΛ ΝΕΟ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ",
    "category": 0,
    "preference": 1,
    "count": 93,
    "year": 2020
  }
]

Αναζήτηση Στατιστικών ανά έτος και πανεπιστήμιο

GET/statistics/{year}/university/{uni_id}

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

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/2020/university/19595

Μέρος Απάντησης

[
  [
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 1,
      "count": 2,
      "year": 2020
    },
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 2,
      "count": 5,
      "year": 2020
    }
  ]
]

Αναζήτηση Στατιστικών ανά πανεπιστήμιο και κατηγορία

GET /statistics/university/{uni_id}/category/{category}

Επιστρέφει το σύνολο των στατιστικών για το πανεπιστήμιο και τη κατηγορία που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/university/19595/category/1

Μέρος Απάντησης

[
  [
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 1,
      "preference": 1,
      "count": 1,
      "year": 2020
    },
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 1,
      "preference": 2,
      "count": 1,
      "year": 2020
    }
  ]
]

Αναζήτηση Στατιστικών ανά τμήμα και κατηγορία

GET /statistics/department/{dept_id}/category/{category}

Επιστρέφει το σύνολο των στατιστικών για το τμήμα και τη κατηγορία που δίνεται.

Φίλτρα

Εκτός από τα γενικά φίλτρα των στατιστικών, στην αναζήτηση ανά τμήμα και κατηγορία μπορούν να εφαρμοστούν και τα παρακάτω:

type=gel-ime-gen

Επιστρέφει τα στατιστικά που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 90% ημερήσιων ΓΕΛ

type=epal-ime-gen

Επιστρέφει τα στατιστικά που αντιστοιχούν στα αποτελέσματα σχετικά με την κατηγορία 90% ημερήσιων ΕΠΑΛ

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/department/1625/category/1

Μέρος Απάντησης

[
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 1,
    "preference": 1,
    "count": 1,
    "year": 2020
  },
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 1,
    "preference": 2,
    "count": 1,
    "year": 2020
  }
]

Αναζήτηση Στατιστικών ανά έτος, τμήμα και κατηγορία

GET /statistics/{year}/department/{dept_id}/category/{category}

Επιστρέφει το σύνολο των στατιστικών για το έτος, το τμήμα και τη κατηγορία που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/2020/department/1625/category/1

Μέρος Απάντησης

[
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 1,
    "preference": 1,
    "count": 1,
    "year": 2020
  },
  {
    "code": 1625,
    "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
    "category": 1,
    "preference": 2,
    "count": 1,
    "year": 2020
  }
]

Αναζήτηση Στατιστικών ανά έτος, πανεπιστήμιο και κατηγορία

GET /statistics/{year}/university/{uni_id}/category/{category}

Επιστρέφει το σύνολο των στατιστικών για το έτος, το πανεπιστήμιο και τη κατηγορία που δίνεται.

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/2020/university/19595/category/1

Μέρος Απάντησης

[
  [
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 1,
      "count": 2,
      "year": 2020
    },
    {
      "code": 1601,
      "examType": "10% ΓΕΛ ΗΜΕΡΗΣΙΑ & ΕΣΠΕΡΙΝΑ 2018",
      "category": 0,
      "preference": 2,
      "count": 5,
      "year": 2020
    }
  ]
]

Ελάχιστο και Μέγιστο Έτος Δεδομένων Στατιστικών

GET/statistics/?year=min

GET/statistics/?year=max

Μπορείτε να αναζητήσετε το ελάχιστο και το μέγιστο έτος των δεδομένων που προσφέρονται για τα στατιστικά με τα παρακάτω φίλτρα:

year=min
year=max

Παράδειγμα Ερωτήματος

https://vaseis.iee.ihu.gr/api/index.php/statistics/?year=min

Τυπική Απάντηση

{
  "minYear": 2016
}