Demo API Δαπανών Ε&Α
Αποτελέσματα Απάντησης API
Αυτό το έγγραφο περιγράφει την λειτουργία ενός API (Application Programming Interface) για την ανάκτηση δεδομένων δαπανών Έρευνας & Ανάπτυξης (Ε&Α).
Τεκμηρίωση API για Δεδομένα Δαπανών Έρευνας & Ανάπτυξης (Ε&Α)
1. Εισαγωγή
Το παρόν API επιτρέπει την προγραμματική πρόσβαση στα δεδομένα δαπανών Ε&Α. Τα δεδομένα είναι ετήσια και ομαδοποιούνται ανά Γεωπολιτική Οντότητα, Τομέα Απόδοσης και Έτος.
2. Βασική Διεύθυνση (Base URL)
Υποθετική Βασική Διεύθυνση: https://marmot-diverse-mastodon.ngrok-free.app/get-data
3. Τελικά Σημεία (Endpoints)
3.1. Ανάκτηση δεδομένων δαπανών Ε&Α
Αυτό το τελικό σημείο επιστρέφει ετήσια δεδομένα δαπανών Ε&Α με βάση τις καθορισμένες παραμέτρους.
| Μέθοδος HTTP | Διαδρομή (Path) | Περιγραφή |
|---|---|---|
| GET | get-data |
Ανακτά τα δεδομένα Ε&Α με φιλτράρισμα. |
3.2. Παράμετροι Ερωτήματος (Query Parameters)
| Όνομα Παραμέτρου | Τύπος | Απαιτείται | Περιγραφή | Πιθανές Τιμές (Ενδεικτικά) |
|---|---|---|---|---|
entity |
String | ΝΑΙ | Η γεωπολιτική οντότητα/χώρα. | Ελλάδα, Γερμανία, Ευρωπαϊκή Ένωση - 27 χώρες (από το 2020), Ηνωμένες Πολιτείες, Κίνα εκτός από το Χονγκ Κονγκ, κ.λπ. |
sector |
String | ΟΧΙ | Ο τομέας απόδοσης. | Όλοι οι τομείς, Επιχειρηματικός τομέας, Δημόσιος τομέας, Τομέας τριτοβάθμιας εκπαίδευσης, Ιδιωτικός μη κερδοσκοπικός τομέας |
year |
Integer | ΟΧΙ | Έτος (π.χ. 1980). | 1980 – 2024 |
4. Απάντηση (Response)
4.1. Επιτυχής Απάντηση (200 OK)
Επιστρέφει μια λίστα αντικειμένων JSON.
Παράδειγμα Σώματος Απάντησης:
[
{
"Χρονική_συχνότητα": "Ετήσιος",
"Τομέας_απόδοσης": "Όλοι οι τομείς",
"Μονάδα_μέτρησης": "Εκατομμύριο ευρώ",
"Γεωπολιτική_οντότητα": "Ελλάδα",
"Έτος": 2021,
"Κατάσταση": "μι",
"Αξία": 2645.942
},
{
"Χρονική_συχνότητα": "Ετήσιος",
"Τομέας_απόδοσης": "Όλοι οι τομείς",
"Μονάδα_μέτρησης": "Εκατομμύριο ευρώ",
"Γεωπολιτική_οντότητα": "Ελλάδα",
"Έτος": 2022,
"Κατάσταση": "",
"Αξία": 3070.304
}
]4.2. Περιγραφή Πεδίων Δεδομένων
| Πεδίο (Key) | Τύπος | Περιγραφή | Σημειώσεις για την Κατάσταση |
|---|---|---|---|
Χρονική_συχνότητα |
String | Η χρονική συχνότητα της μέτρησης. | Πάντα “Ετήσιος”. |
Τομέας_απόδοσης |
String | Ο τομέας όπου πραγματοποιήθηκε η δαπάνη Ε&Α. | Ανατρέξτε στην ενότητα 5.1. |
Μονάδα_μέτρησης |
String | Η μονάδα μέτρησης της αξίας. | Πάντα “Εκατομμύριο ευρώ”. |
Γεωπολιτική_οντότητα |
String | Η χώρα ή ο γεωπολιτικός σχηματισμός αναφοράς. | Ανατρέξτε στην ενότητα 5.2. |
Έτος |
Integer | Το έτος αναφοράς. | |
Κατάσταση |
String | Δείκτης ποιότητας ή ειδικής επεξεργασίας δεδομένων. | Ανατρέξτε στην ενότητα 4.3. |
Αξία |
Number | Η δαπάνη Ε&Α σε εκατομμύρια ευρώ. |
4.3. Επεξήγηση Κωδικών Κατάστασης (Status Codes)
Οι κωδικοί κατάστασης παρέχουν πληροφορίες σχετικά με την ποιότητα ή τη φύση της αξίας (Αξία). Με βάση τις συνήθεις στατιστικές πρακτικές (π.χ. Eurostat):
| Κωδικός | Επεξήγηση | Αγγλική Μετάφραση (Πιθανή) |
|---|---|---|
μι (mi) | Εκτιμώμενα στοιχεία. | Estimated data |
σι (si) | Στατιστική ασυνέχεια. | Statistical break/discontinuity |
ρε (re) | Αναθεωρημένα στοιχεία. | Revised data |
π (p) | Προσωρινά στοιχεία. | Provisional data |
εσύ (esu) | Εκτίμηση Eurostat / Ειδική Σημείωση (Less clear from raw data) | Eurostat estimate / Special Note |
| Κενό | Τελικά/οριστικά στοιχεία. | Final data |
4.4. Απάντηση Σφάλματος (Error Response)
| Κωδικός HTTP | Περιγραφή | Παράδειγμα Σώματος Απάντησης |
|---|---|---|
400 Bad Request |
Λείπει η υποχρεωτική παράμετρος entity. |
|
404 Not Found |
Δεν βρέθηκαν δεδομένα για τα καθορισμένα κριτήρια. | |
5. Πίνακες Αναφοράς
5.1. Πιθανές Τιμές για sector (Τομέας απόδοσης)
- Όλοι οι τομείς
- Επιχειρηματικός τομέας
- Δημόσιος τομέας
- Τομέας τριτοβάθμιας εκπαίδευσης
- Ιδιωτικός μη κερδοσκοπικός τομέας
5.2. Πιθανές Τιμές για entity (Γεωπολιτική οντότητα)
- Ευρωπαϊκή Ένωση – 27 χώρες (από το 2020)
- Ευρωζώνη – 20 χώρες (από το 2023)
- Ευρωζώνη – 19 χώρες (2015-2022)
- Βέλγιο
- Βουλγαρία
- Τσεχία
- Δανία
- Γερμανία
- Εσθονία
- Ιρλανδία
- Ελλάδα
- Ισπανία
- Γαλλία
- Κροατία
- Ιταλία
- Κύπρος
- Λατβία
- Λιθουανία
- Λουξεμβούργο
- Ουγγαρία
- Μάλτα
- Ολλανδία
- Αυστρία
- Πολωνία
- Πορτογαλία
- Ρουμανία
- Σλοβενία
- Σλοβακία
- Φινλανδία
- Σουηδία
- Ισλανδία
- Νορβηγία
- Ελβετία
- Ηνωμένο Βασίλειο
- Βοσνία και Ερζεγοβίνη
- Μαυροβούνιο
- Βόρεια Μακεδονία
- Αλβανία
- Σερβία
- Τουρκιγιέ
- Ρωσία
- Ηνωμένες Πολιτείες
- Κίνα εκτός από το Χονγκ Κονγκ
- Ιαπωνία
- Νότια Κορέα
Leave a Reply