|
|
Τα ανοικτά δεδομένα που είναι καταχωρημένα στο σύστημα [Edulabs](http://edulabs.minedu.gov.gr) είναι διαθέσιμα και μέσω API σε μορφη JSON.
|
|
|
|
|
|
Η αναλυτική τεκμηρίωση των παρεχόμενων λειτουργιών καθώς και δοκιμαστικό περιβάλλον είναι διαθέσιμα στη [διεύθυνση τεκμηρίωσης]:(http://edulabs.minedu.gov/_doc/swagger/index.html). Η τεκμηρίωση είναι βασισμένη στο πρότυπο [Swagger](http://swagger.io/specification/) (έκδοση 2).
|
|
|
|
|
|
## Γενική περιγραφή
|
|
|
|
|
|
### Στοιχεία σελιδοποίησης
|
|
|
|
|
|
Τα δεδομένα παρέχονται σε μορφή JSON και είναι στην πλειονότητα τους σελιδοποιημένα. Το πλήθος αποτελεσμάτων ανά σελίδα είναι παραμετροποιήσιμο, με μέγιστο πλήθος αποτελεσμάτων 200. Τα δεδομένα περιλαμβάνουν τις παρακάτω ιδιότητες που ο προγραμματιστής μπορεί να εκμεταλλευτεί για να πλοηγηθεί στο σύνολο των αποτελεσμάτων:
|
|
|
|
|
|
* _count_: πλήθος αποτελεσμάτων στα επιστρεφόμενα αποτελέσματα
|
|
|
* _countall_: συνολικό πλήθος αποτελεσμάτων που ικανοποιούν τα κριτήρια
|
|
|
* _page_: τρέχων αριθμός "σελίδας" αποτελεσμάτων
|
|
|
* _pages_: συνολικός αριθμός σελίδων
|
|
|
|
|
|
Παράδειγμα:
|
|
|
```json
|
|
|
{
|
|
|
"count": 20,
|
|
|
"countall": 7418,
|
|
|
"page": 1,
|
|
|
"pages": 371,
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### Κατάσταση αιτήματος
|
|
|
|
|
|
Τα δεδομένα περιλαμβάνουν τα παρακάτω πεδία για τον προσδιορισμό της κατάστασης του αιτήματος. Σε περίπτωση που δεν επιστραφούν καθόλου δεδομένα, θα πρέπει να εξεταστεί το http status code του response.
|
|
|
|
|
|
* _status_: το http status code της απάντησης, για παράδειγμα 200, 404, 400
|
|
|
* _success_: ένδειξη επιτυχούς απάντησης
|
|
|
|
|
|
Παράδειγμα:
|
|
|
```json
|
|
|
{
|
|
|
"status": 200,
|
|
|
"success": true,
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### Αιτούμενα στοιχεία
|
|
|
|
|
|
Τα δεδομένα περιλαμβάνουν δύο πεδία για τον προσδιορισμό των επιστρεφόμενων στοιχείων και κατάλληλων ετικετών τους.
|
|
|
|
|
|
* _labels_: ετικέτες των πεδίων των επιστρεφόμενων στοιχείων
|
|
|
* _data_: τα επιστρεφόμενα στοιχεία
|
|
|
|
|
|
Παράδειγμα:
|
|
|
```json
|
|
|
"labels": {
|
|
|
"registry_no": "Κωδικός μονάδας",
|
|
|
"school_name": "Ονομασία",
|
|
|
"school_type": "Τύπος μονάδας",
|
|
|
"prefecture": "Περιφερειακή ενότητα",
|
|
|
"municipality": "Δήμος",
|
|
|
"eduadmin": "Διεύθυνση εκπαίδευσης",
|
|
|
"region_edu_admin": "Περιφερειακή διεύθυνση εκπαίδευσης",
|
|
|
"education_level": "Βαθμίδα εκπαίδευσης"
|
|
|
},
|
|
|
"data": [
|
|
|
{
|
|
|
"registry_no": "1765010",
|
|
|
"school_name": "ΗΜΕΡΗΣΙΟ ΓΕΝΙΚΟ ΛΥΚΕΙΟ ΑΣΗΜΙΟΥ ΗΡΑΚΛΕΙΟΥ",
|
|
|
"school_type": "ΓΕΝΙΚΟ ΛΥΚΕΙΟ",
|
|
|
"prefecture": "ΗΡΑΚΛΕΙΟΥ",
|
|
|
"municipality": "ΓΟΡΤΥΝΑΣ",
|
|
|
"eduadmin": "ΔΙΕΥΘΥΝΣΗ Δ.Ε. ΗΡΑΚΛΕΙΟΥ",
|
|
|
"region_edu_admin": "ΠΕΡΙΦΕΡΕΙΑΚΗ ΔΙΕΥΘΥΝΣΗ ΚΡΗΤΗΣ",
|
|
|
"education_level": "ΔΕΥΤΕΡΟΒΑΘΜΙΑ"
|
|
|
},
|
|
|
{
|
|
|
"registry_no": "3202010",
|
|
|
"school_name": "1ο ΗΜΕΡΗΣΙΟ ΓΥΜΝΑΣΙΟ ΙΕΡΑΠΕΤΡΑΣ ΛΑΣΙΘΙΟΥ",
|
|
|
"school_type": "ΓΥΜΝΑΣΙΟ",
|
|
|
"prefecture": "ΛΑΣΙΘΙΟΥ",
|
|
|
"municipality": "ΙΕΡΑΠΕΤΡΑΣ",
|
|
|
"eduadmin": "ΔΙΕΥΘΥΝΣΗ Δ.Ε. ΛΑΣΙΘΙΟΥ",
|
|
|
"region_edu_admin": "ΠΕΡΙΦΕΡΕΙΑΚΗ ΔΙΕΥΘΥΝΣΗ ΚΡΗΤΗΣ",
|
|
|
"education_level": "ΔΕΥΤΕΡΟΒΑΘΜΙΑ"
|
|
|
}
|
|
|
]
|
|
|
```
|
|
|
|
|
|
>
|
|
|
> _Αναλυτικές λεπτομέρειες παρέχονται στη [σελίδα τεκμηρίωσης](http://edulabs.minedu.gov/_doc/swagger/index.html)._
|
|
|
> |
|
|
\ No newline at end of file |