Tag Archives: DIavgeia

Χρήσιμες οδηγίες για την ανάρτηση μέσω API

Για να μπορέσουμε να αναρτήσουμε σωστά μέσω του API του νέου συστήματος Διαύγεια, βασική προϋπόθεση είναι να έχουμε δημιουργήσει έναν χρήστη ο οποίος έχει δικαιώματα ανάρτησης μέσω API.

Με πρόσφατη αλλαγή στην εφαρμογή του Προγράμματος Διαύγεια, μετά την Υπουργική Απόφαση 14492 ΕΞ 2021 (https://diavgeia.gov.gr/legislationdocs/ΝΟΜΟΘΕΣΙΑ/ΝΟΜΟΙ/14492_2021.pdf) όπως αυτή εξειδικεύτηκε και με την 10455 ΕΞ 2022 (https://diavgeia.gov.gr/doc/9ΙΒΦ46ΜΤΛΠ-4ΞΚ?inline=true) εγκύκλιο, η ευθύνη και η δυνατότητα ορισμού χρηστών ως API δόθηκε στους Διαχειριστές χρηστών Διαύγεια των φορέων ως ένα επιπλέον δικαίωμα του χρήστη (οδηγίες για την επεξεργασία χρηστών μπορούν να βρεθούν από τον Διαχειριστή στον Οδηγό Διαχειριστή Φορέα – επιλογή «Ενέργειες Διαχειριστή Φορέα» – στο Εκπαιδευτικό Υλικό – https://diavgeia.gov.gr/educationalMaterial – του Προγράμματος Διαύγεια μετά την είσοδο του και στην ενότητα αναζήτησης & επεξεργασίας χρηστών – 4.2 – αυτού). Έτσι, ο Διαχειριστής Διαύγεια κάθε φορέα μπορεί να ορίσει υπάρχοντα χρήστη ή να δημιουργήσει νέο ως χρήστη 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/luminapi/opendata//organizations/10599/signers.json