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": 96087,
      "title": "ΔΙ.ΠΑ.Ε.",
      "full-title": "Διεθνές Πανεπιστήμιο της Ελλάδος"
    },
    {
      "id": 96118,
      "title": "ΔΠΘ",
      "full-title": "Δημοκρίτειο Πανεπιστήμιο Θράκης"
    }
]
}
                            

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

GET /universities/{uni_id}

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

Παράδειγμα Ερωτήματος
https://vaseis.iee.ihu.gr/api/index.php/universities/96025
Παράδειγμα Απάντησης
{
  "id": "96025",
  "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/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/dept/{dept_id}

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

Φίλτρα

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

  • details=full

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

Παράδειγμα Ερωτήματος
https://vaseis.iee.ihu.gr/api/index.php/bases/dept/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}/dept/{dept_id}

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

Παράδειγμα Ερωτήματος
https://vaseis.iee.ihu.gr/api/index.php/bases/2020/dept/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

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

Μέρος Τυπικής Απάντησης
[
{
  "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": 96087
}

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

GET /departments/university/{uni_id}

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

Παράδειγμα Ερώτησης
https://vaseis.iee.ihu.gr/api/index.php/departments/university/96025
Μέρος Απάντησης
[
{
    "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/96087
Μέρος Απάντησης
[
  [
    {
      "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/96087
Μέρος Απάντησης
[
  [
    {
      "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/96087/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/96087/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
}