Γενικά
Το @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: (Προαιρετική): Επιτρέπει την αναζήτηση βάσει του τύπου απόσπασης. Δείτε εδώ τους πιθανούς τύπους απόσπασης
Παραδείγματα
Αναζήτηση των αποσπάσεων του έτους 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