API

Το @pospaseis προσφέρει μια διεπαφή προγραμματισμού εφαρμογής (Application Programming Interface-API) που παρέχει έναν εύχρηστο τρόπο ανάκτησης των αποτελεσμάτων μιας αναζήτησης σε μορφή JSON. Έτσι, To @pospaseis δίνει τη δυνατότητα σε οποιονδήποτε προγραμματιστή να πραγματοποιήσει αναζητήσεις μέσα από την εφαρμογή του ή το site του.

Οδηγίες χρήσης του API

Το API του @pospaseis ακολουθεί την λογική REST. Ως εκ τούτου, η χρήση του API είναι ιδιαίτερα απλή: Αρκεί να κάνετε ένα αίτημα http στο script που βρίσκεται στη διεύθυνση:

http://www.apospaseis.eu/api.php

με τις εξής παραμέτρους:

• search_type (Υποχρεωτική): Η τιμή μπορεί να είναι είτε search είτε statistics και δηλώνει αν ο χρήστης επιθυμεί την ανάκτηση των δεδομένων των αποσπάσεων ή των στατιστικών στοιχείων των αποσπάσεων
• am: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του αρισθμού μητρώου του εκπαιδευτικού
• lastname: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του επώνυμου του εκπαιδευτικού. Η αναζήτηση στη βάση δεδομένων γίνεται με βάση του τελεστή SQL LIKE. Έτσι δεν είναι απαραίτητο το επώνυμο να πληκτρολογηθεί ακριβώς όπως είναι καταχωρημένο στη βάση δεδομένων
• firstname: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του ονόματος του εκπαιδευτικού. Η αναζήτηση στη βάση δεδομένων γίνεται με βάση του τελεστή SQL LIKE. Έτσι δεν είναι απαραίτητο το όνομα να πληκτρολογηθεί ακριβώς όπως είναι καταχωρημένο στη βάση δεδομένων
• vathmida: (Προαιρετική): Παίρνει τιμή είτε ΔΕ είτε ΠΕ δηλώνοντας αν ο εκπαιδευτικός ανήκει στην Δευτεροβάθμια εκπαίδευση ή στην Πρωτοβάθμια. Με αυτό τον τρόπο επιτρέπεται η αναζήτηση βάσει βαθμίδας εκπαίδευσης
• eidikotita: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει ειδικότητας. Δείτε εδώ τις ειδικότητες των εκπαιδευτικών
• organiki: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει της οργανικής θέσης, ή καλύτερα, βάσει του από που μετακινήθηκε ο εκπαιδευτικός στη νέα του θέση. Η αναζήτηση στη βάση δεδομένων γίνεται με βάση του τελεστή SQL LIKE. Έτσι δεν είναι απαραίτητο το πεδίο να πληκτρολογηθεί ακριβώς όπως είναι καταχωρημένο στη βάση δεδομένων
• year_apospasi: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει σχολικού έτους απόσπασης. Το έτος απόσπασης έχει μορφή 2015-2016
• foreas: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του φορέα απόσπασης (που αποσπάσθηκε ο εκπαιδευτικός). Η αναζήτηση στη βάση δεδομένων γίνεται με βάση του τελεστή SQL LIKE. Έτσι δεν είναι απαραίτητο ο φορέας απόσπασης να πληκτρολογηθεί ακριβώς όπως είναι καταχωρημένο στη βάση δεδομένων
• type: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του τύπου απόσπασης. Δείτε εδώ τους πιθανούς τύπους απόσπασης

Παραδείγματα ερωτημάτων στο API

Για να γίνει εύκολα κατανοητό το πως χρησιμοποιείται το API του @pospaseis, παρακάτω δίνονται τέσσερα παραδείγματα χρήσης:

Αναζήτηση των αποσπάσεων του έτους 2015-2016 των εκπαιδευτικών πληροφορικής (ΠΕ19-20) που έγιναν στα Πανεπιστήμια-ΤΕΙ

http://www.apospaseis.eu/api.php?search_type=search&eidikotita=ΠΕ19-20&type=Πανεπιστήμια-ΤΕΙ&year_apospasi=2015-2016

Αναζήτηση στατιστικών για τις αποσπάσεις των εκπαιδευτικών πληροφορικής (ΠΕ19-20)

http://www.apospaseis.eu/api.php?search_type=statistics&eidikotita=ΠΕ19-20

Αναζήτηση των αποσπάσεων που έχουν πάρει οι εκπαιδευτικοί με επώνυμο που περιέχει του χαρακτήρες "παδόπουλο"

http://www.apospaseis.eu/api.php?search_type=search&lastname=παδόπουλο

Αναζήτηση των αποσπάσεων που έχουν πάρει ο εκπαιδευτικός με αριθμό μητρώου 567891

http://www.apospaseis.eu/api.php?search_type=search&am=567891