Γενικές Πληροφορίες

Στο παρόν κείμενο γίνεται αναφορά σε ένα υποσύνολο των λειτουργιών που διατίθενται από το API του Εθνικού Μητρώου Διαδικασιών του Ελληνικού Δημοσίου.

Πρόσβαση - Αυθεντικοποίηση

To Mitos API προσφέρει μια μορφή ελέγχου ταυτότητας:

Api Key Authentication

Για να αποκτήσετε πρόσβαση, θα πρέπει να αποστείλετε e-mail στο api@mitos.gov.gr

Βασικές πληροφορίες API

To σύνολο των API endpoints είναι προσβάσιμα μέσω του API_BASE_URL:

https://api.digigov.grnet.gr/

Το σύνολο των endpoints ορίζονται από συγκεκριμένη έκδοση ΑPI_VERSION. Η παρούσα έκδοση είναι η /v1.

Κάθε endpoint επιστρέφει την πληροφορία σε μορφή JSON και τα επιστρεφόμενα πεδία εξαρτώνται από το υποσυστημα από την οποία φέρει την πληροφορία.

{ "data: { "id": "string", "title": { "el": "string", "en": "string" }, }, "total": 0, "next_page": 0, "current_page": 0, "limit": 0, "success": true }

Η επιστρεφόμενη πληροφορία προς κατανάλωση ζεί στο object data ενώ κάθε επιστρεφόμενο object έχει απαραίτητα τις τιμές id και title.

Σε endpoint που επιστρέφουν πολλαπλά αποτελέσματα δίνεται δυνατότητα επιστροφής αποτελεσμάτων με σελιδοποίηση χρησιμοποιώντας τις παραμέτρους page και limit

?page=1&limit=100

Βασικές κλήσεις στο API

Εμφάνιση όλων των διαδικασιών

Επιστρέφει το σύνολο των διαδικασιών που φιλοξενούνται στο mitos.gov.gr (με σελιδοποίηση). Επιστρέφει το μοναδικό 6ψηφιο αναγνωριστικό καθε διαδικασίας μαζί με τον τίτλο της.

curl -X GET "API_BASE_URL/API_VERSION/services

Π.χ. :

curl -X GET https://api.digigov.grnet.gr/v1/services?page=1&limit=100

Εμφάνιση συγκεκριμένης διαδικασίας

Επιστρέφει την πληροφορία που αφορά μια διαδικασία του mitos.gov.gr. Ως παράμετρο παίρνει ένα από τα παρακάτω:

το μοναδικό 6ψηφιο αναγνωριστικό μιας διαδικασίας ( id ),
το μοναδικό 32ψηφιο αναγνωριστικό μιας διαδικασίας ( uuid ),
τον μοναδικό τίτλο μιας διαδικασίας

Το σύνολο των πεδίων της διαδικασίας περιέχονται μέσα στο object metadata και είναι οργανωμένα κάτω από τις ομάδες πεδίων που αναφέρθηκαν σε προηγούμενη ενότητα.

Για την καλύτερη κατανόηση της παρεχόμενης πληροφορίας μπορείτε να βλέπετε παράλληλα και τη διαδικασία όπως αυτή προβάλλεται στο mitos.gov.gr

Ειδικότερα με βάση το id μπορείτε να βρίσκεται άμεσα τον σύνδεσμο καθε διαδικασίας ακολουθώντας το https://id.mitos.gov.gr/XXXXXX

Βάση του 6ψήφιου ID της

curl -X GET API_BASE_URL/API_VERSION/services/{id}

Βάση του UUID της

curl -X GET API_BASE_URL/API_VERSION/services/{uuid}

Αντιστοίχιση πεδίων με τρίτα APIs

Παρακάτω μπορείτε να δείτε τα διάφορα πεδία τα οποία για να αντλήσετε την πλήρη πληροφορία τους θα πρέπει να καλέσετε τρίτα APIs του mitos.gov.gr. Για κάθε πεδίο δίνεται ο συνολικός κατάλογος και το endpoint για την singular πληροφορία του κάθε πεδίου.

Φορείς

org_owner
provision_org
step_co_org
step_digital_co_org
org_owner_private (αν και σπανιά θα το συναντήσετε)

Κατάλογος Φορέων

curl -X GET https://api.digigov.grnet.gr/v1/organizations

curl -X GET https://api.digigov.grnet.gr/v1/organizations?page=2&limit=100

Πληροφορίες Φορέα

Για να αντλήσουμε πληροφορίες για έναν φορέα καλούμε:

curl -X GET https://api.digigov.gr/v1/organization?id={org_id}