Για να μπορέσουμε να αναρτήσουμε σωστά μέσω του API του νέου συστήματος Διαύγεια, βασική προυπόθεση είναι να έχουμε δημιουργήσει έναν χρήστη ο οποίος έχει δικαιώματα ανάρτησης μέσω API. Το σχετικό δικαίωμα δίνεται από τον διαχειριστή του Διαύγεια μετά από αίτημα του υπέυθηνου ΟΔΕ του φορέα.
Ο χρήστης με δικαίωμα ανάρτησης από τρίτα συστήματα θα μπορεί να αναρτά αποφάσεις για οποιαδήποτε μονάδα του φορέα του μόνο μέσω κλήσεων του API. Δεν θα μπορεί δηλαδή να αναρτήσει κάνοντας login στον δικτυακό τόπο του Διαύγεια όπως ένας κανονικός χρήστης.
Για την επιτυχή ανάρτηση μέσω του API , θα πρέπει επιπλέον να δοθεί προσοχή στα μεταδεδομένα που αφορούν τον Οργανισμό , την μονάδα και τον υπογράφοντα , όταν καλούμε κάποια μέθοδο. Πιο συγκεκριμένα , θα πρέπει να βεβαιωθούμε ότι οι τιμές για τα
organizationId , UnitIds και signerIds
είναι σωστές και πιο συγκεριμένα ότι :
- το organizationId αναφέρεται στον οργανισμό στον οποίο ανήκει ο χρήστης API με τα στοιχεία του οποίου αναρτούμε.
- το unitIds , έχει τιμές που αντιστοιχούν σε μονάδες του οργανισμού για τον οποίον αναρτούμε. Για να δούμε όλες τις μονάδες ενός φορέα μέσω του api θα πρέπει να κάνει μια κληση στην διευθυνσή :https://[API_BASE_URL]/organizations/[ORG_ID]/units , όπου [ORG_ID] το ID του φορέα που μας ενδιαφέρει. π.χ https://test3.diavgeia.
gov.gr/luminapi/opendata// organizations/10599/units - ότι το signerId, αντιστοιχεί σε υπογράφοντα που έχει δικαίωμα υπογραφής στην συγκεκριμένη μονάδα κάτω από την οποία δημοσιέυεται η απόφαση (1) . Αυτό μπορεί να γίνει με μια κλήση σαν την παρακάτω : https://[API_BASE_URL]/organizations/[ORG_ID]/signers, όπου [ORG_ID] το ID του φορέα που μας ενδιαφέρει.π.χ https://test3.diavgeia.gov.gr/
luminapi/opendata// organizations/10599/signers (2)
Σημειώσεις
(1) Σημειώνεται ότι στο νέο πληροφοριακό σύστημα του Διαύγεια, μπορεί να δοθεί η δυνατότητα σε κάποιον υπογράφοντα να υπογράφει σε όλες τις μονάδες του φορέα του.
(Αρχική -> Διαχείριση υπογραφόντων -> Επεξεργασία υπογράφοντα και check το Δικαίωμα υπογραφής σε όλες τις μονάδες).
(2) Σημειώνεται ότι μπορούμε να πάρουμε τα αντίστοιχα Output σε μορφή json , προσθέτωντας το .json στο τέλος του URL. π.χ https://test3.diavgeia.gov.gr/