Function GetEduAdmins
ΛΕΞΙΚΟ : Διευθύνσεις Εκπαίδευσης
Η συνάρτηση αυτή επιστρέφει Διευθύνσεις
Εκπαίδευσης σύμφωνα με τις παραμέτρους που
έγινε η κλήση.
Η κλήση μπορεί να γίνει μέσω της παρακάτω
διεύθυνσης με τη μέθοδο GET και
route_api_name = edu_admins :
https://mm.sch.gr/api/edu_admins
Ορισμός Τύπου και Πεδίου Ταξινόμησης Αποτελεσμάτων
- Μέσω των παραμέτρων Πεδίο Ταξινόμησης ($orderby) και Τύπος Ταξινόμησης ($ordertype) μπορεί να καθοριστεί το πεδίο και η σειρά ταξινόμησης.
- Προκαθορισμένη τιμή πεδίου ταξινόμησης είναι η αύξουσα σειρά ASC.
- Προκαθορισμένη τιμή τύπου ταξινόμησης είναι το Όνομα.
Ορισμός Αριθμού Σελίδας και Εγγραφών/Σελίδα της Επιστροφής Αποτελεσμάτων
- Μέσω των παραμέτρων Αριθμός Σελίδας ($page) και Αριθμός Εγγραφών/Σελίδα ($pagesize) μπορεί να καθοριστεί ο αριθμός Σελίδας και Εγγραφών/Σελίδα της επιστροφής αποτελεσμάτων.
- Ο προκαθορισμένος αριθμός Εγγραφών/Σελίδα που επιστρέφονται ανά κλήση είναι 0.
- Ο προκαθορισμένος αριθμός Σελίδας που επιστρέφεται ανά κλήση είναι 1.
Ορισμός Τύπου Αναζήτησης Αποτελεσμάτων
- Μέσω των παραμέτρων Τύπου Αναζήτησης ($searchtype) μπορεί να καθοριστεί μπορεί να καθοριστεί ο τρόπος με τον οποίο θα αναζητηθεί η τιμή της παραμέτρου στο DNS της Μονάδας.
- Ισχύει για όσες παραμέτρους το υποστηρίζουν το συνδυασμό με την παράμετρο searchtype.
- Προκαθορισμένη τιμή τύπου αναζήτησης είναι CONTAINALL.
Πίνακας Παραμέτρων
- Στον Πίνακα Παραμέτρων Parameters summary εμφανίζονται όλοι οι παράμετροι με τους οποίους μπορεί να γίνει η κλήση της συνάρτησης.
- Όλοι οι παράμετροι είναι προαιρετικοί εκτός από αυτές που έχουν χαρακτηριστεί ως υποχρεωτικοί.
- Οι παράμετροι μπορούν να χρησιμοποιηθούν με οποιαδήποτε σειρά.
- Οι παράμετροι οι οποίοι έχουν το χαρακτηριστικό (Συνδυάζεται με την παράμετρο searchtype) σημαίνει ότι η συγκεκριμένη παράμετρος συνδυάζεται με την παράμετρο searchtype.
- Οι παράμετροι μπορούν να πάρουν τιμή "NULL" για να αναζητήσουν τις κενές εγγραφές στα αντίστοιχα πεδία
Πίνακας Αποτελεσμάτων
- Στον Πίνακα Αποτελεσμάτων Return value summary εμφανίζονται οι μεταβλητές που επιστρέφει η συνάρτηση.
- Όλες οι μεταβλητές επιστρέφονται σε JSON objects.
- Η μεταβλητή data είναι ο πίνακας με τα δεδομένα.
- Η μεταβλητή status καθορίζει αν η εκτέλεση της συνάρτησης ήταν επιτυχής (κωδικός 200) ή προέκυψε κάποιο σφάλμα.
Πίνακας Σφαλμάτων
- Στον Πίνακα Σφαλμάτων Thrown exceptions summary εμφανίζονται τα Μηνύματα Σφαλμάτων που μπορεί να προκύψουν κατά την κλήση της συνάρτησης.
- Οι περιγραφές των Σφαλμάτων καθώς και οι
Κωδικοί τους είναι διαθέσιμες μέσω του
πίνακα Μηνύματα Σφαλμάτων (
ExceptionMessages
) και Κωδικοί Σφαλμάτων (ExceptionCodes
) αντίστοιχα.
Παραδείγματα Κλήσης
- Υπάρχουν διαθέσιμα παραδείγματα κλήσης
της συνάρτησης με διάφορους τρόπους (
ApiRequestExamples
).
Μηνύματα Authentication/Authorization
- Υπάρχουν αναλυτικές πληροφορίες για τα
μηνύματα Authentication/Authorization (
AuthMessages
).
Μηνύματα Προκαθορισμένων Παραμέτρων
- Υπάρχουν αναλυτικές πληροφορίες για τα
μηνύματα Προκαθορισμένων Παραμέτρων (
StandarParamsMessages
).
Δεδομένα Επιστροφής
Παρακάτω εμφανίζονται τα
αποτελέσματα σε μορφή JSON :
{ "data": [{}], "controller": "GetEduAdmins", "function": "edu_admins", "method": "GET", "total": ``, "count": ``, "pagination": { "page": 1, "maxPage": 1, "pagesize": 0}, "status": 200, "message": "[GET][edu_admins]:success" }
Πίνακας Δεδομένων
Παρακάτω εμφανίζεται ένα δείγμα
από τον πίνακα data με τα αποτελέσματα σε
μορφή JSON :
{"data": [{ "edu_admin_id": ``, "edu_admin": ``, "registry_no": ``, "parent_rdn": ``, "third_level_dns": ``, "region_edu_admin_id": ``, "region_edu_admin_name": ``, "implementation_entity_id": ``, "implementation_entity": ``, "implementation_entity_initials": `` }] }
mixed |
$edu_admin |
Διεύθυνση Εκπαίδευσης Το Όνομα ή ο Κωδικός ID της Διευθύνσης Εκπαίδευσης Η τιμή της παραμέτρου μπορεί να είναι : mixed{integer|string|array[integer|string]}
|
mixed |
$region_edu_admin |
Περιφέρεια Το Όνομα ή ο Κωδικός ID της Περιφέρειας Λεξικό : GetRegionEduAdmins() Η τιμή της παραμέτρου μπορεί να είναι : mixed{integer|string|array[integer|string]}
|
mixed |
$implementation_entity |
Φορέας Υλοποίησης Το Όνομα ή ο Κωδικός ID του Φορέα Υλοποίησης Λεξικό : GetImplementationEntities() Η τιμή της παραμέτρου μπορεί να είναι : mixed{integer|string|null|array[integer|string|null]}
|
string |
$parent_rdn |
Parent RDN Το Parent RDN της Διευθύνσης Εκπαίδευσης Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|null|array[string|null]}
|
string |
$third_level_dns |
Third Level Dns Το Third Level Dns της Διευθύνσης Εκπαίδευσης Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|null|array[string|null]}
|
integer |
$pagesize |
Αριθμός Εγγραφών/Σελίδα Ο αριθμός των εγγραφών που θα επιστρέψουν ανα σελίδα Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε θα επιστραφούν όλες οι προκαθορισμένες εγγραφές ( Parameters::DefaultPageSize )Λίστα Παραμέτρων Σελιδοποίησης : Parameters Η τιμή της παραμέτρου μπορεί να είναι : integer
|
integer |
$page |
Αριθμός Σελίδας Ο αριθμός της σελίδας με τις $pagesize εγγραφές που βρέθηκαν σύμφωμα με τις παραμέτρους Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε θα επιστραφεί η πρώτη σελίδα Λίστα Παραμέτρων Σελίδας : Parameters Η τιμή της παραμέτρου μπορεί να είναι : integer
|
string |
$orderby |
Πεδίο Ταξινόμησης Το όνομα του πεδίου με το οποίο γίνεται η ταξινόμηση των εγγραφών Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η ταξινόμηση γίνεται με το Όνομα Η τιμή της παραμέτρου μπορεί να είναι : string
|
string |
$ordertype |
Τύπος Ταξινόμησης Ο τύπος ταξινόμησης με τον οποίο γίνεται η ταξινόμηση των εγγραφών Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η ταξινόμηση γίνεται με Αύξουσα Σειρά ( OrderEnumTypes::ASC )Λίστα Τύπων Ταξινόμησης : OrderEnumTypes Η τιμή της παραμέτρου μπορεί να είναι : string
|
string |
$searchtype |
Τύπος Αναζήτησης Ο Τύπος Αναζήτησης με τον οποίο γίνεται η αναζήτηση στα πεδία Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η αναζήτηση στα πεδία αυτά γίνεται με τον Τύπο SearchEnumTypes::ContainAll Λίστα Τύπων Αναζήτησης : SearchEnumTypes Η τιμή της παραμέτρου μπορεί να είναι : string
|
Objects<JSON>
|
Επιστρέφει τα παρακάτω JSON objects : array : data : Ο Πίνακας με τα δεδομένα
string : controller : Ο controller που χρησιμοποιείται string : function : Η συνάρτηση που υλοποιείται από το σύστημα string : method : Η μέθοδος κλήσης της συνάρτησης integer : total : Το πλήθος των εγγραφών χωρίς τις παραμέτρους σελιδοποίησης integer : count : Το πλήθος των εγγραφών της κλήσης σύμφωνα με τις παραμέτρους σελιδοποίησης array : pagination : Οι παράμετροι σελιδοποίησης των εγγραφών της κλήσης
integer : status : Ο Κωδικός του αποτελέσματος της κλήσης string : message : Το Μήνυμα του αποτελέσματος της κλήσης |
InvalidEduAdminType
|
ExceptionMessages::InvalidEduAdminType ExceptionCodes::InvalidEduAdminType
|
InvalidEduAdminParentRdnType
|
ExceptionMessages::InvalidEduAdminParentRdnType ExceptionCodes::InvalidEduAdminParentRdnType
|
InvalidEduAdminThirdLevelDnsType
|
ExceptionMessages::InvalidEduAdminThirdLevelDnsType ExceptionCodes::InvalidEduAdminThirdLevelDnsType
|
InvalidRegionEduAdminType
|
ExceptionMessages::InvalidRegionEduAdminType ExceptionCodes::InvalidRegionEduAdminType
|
InvalidImplementationEntityType
|
ExceptionMessages::InvalidImplementationEntityType ExceptionCodes::InvalidImplementationEntityType
|
NoErrors
|
ExceptionMessages::NoErrors ExceptionCodes::NoErrors
|