Χρήσιμες οδηγίες για την ανάρτηση μέσω 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

ΔΙΑΥΓΕΙΑ ΙΙ: ΚΑΙΝΟΤΟΜΙΑ ΣΕ ΔΕΚΑ ΣΗΜΕΙΑ

Την 10η Ιουνίου 2014 τίθεται σε λειτουργία η νέα λειτουργικότητα του Προγράμματος Διαύγεια. To Δι@ύγεια ΙΙ προσφέρει:

  1. Φιλικότερο περιβάλλον για το χρήστη. Καλύτερη οργάνωση της πληροφορίας, απλή δομή και γλώσσα
  2. Εφαρμογή προσβάσιμη από άτομα με αναπηρία σύμφωνα με τα διεθνή πρότυπα
  3. Βελτιωμένο μηχανισμό αναζήτησης με καλύτερα και περισσότερα κριτήρια αναζήτησης και δυνατότητα εξειδίκευσης των αποτελεσμάτων
  4. Προσωποποιημένες υπηρεσίες – “Η Δι@ύγεια μου ” με εξατομικευμένες αναζητήσεις, προσωπικούς σελιδοδείκτες σε αναρτήσεις που ενδιαφέρουν τον κάθε πολίτη
  5. Πληρότητα και ποιότητα της πληροφορίας με αυστηρότερους ελέγχους ορθότητας και πληρότητας κατά την ανάρτηση των αποφάσεων από τους φορείς και ενίσχυση των δυνατοτήτων αυτόματης ενημέρωσης των στοιχείων από τρίτα συστήματα
  6. Ασφάλεια και εγκυρότητα: τα έγγραφα του Δι@ύγεια ΙΙ θα έχουν ψηφιακή υπογραφή του συστήματος που εξασφαλίζει την εγκυρότητά τους. Με ειδική Χρονοσήμανση αποδεικνύεται πότε ακριβώς αναρτήθηκε κάποιο έγγραφο
  7. Βέλτιστο σύστημα διάθεσης ανοικτών δεδομένων: ώστε να αναπτυχθούν περισσότερες εφαρμογές προστιθέμενης αξίας
  8. Διασύνδεση με άλλα συστήματα του Δημοσίου: με άμεση ανταλλαγή πληροφοριών και εγγράφων με άλλα συστήματα του δημοσίου
  9. Μητρώο Φορέων Δημοσίου – Οργανόγραμμα Φορέων με καταγραφή και απεικόνιση του αναλυτικού οργανογράμματος κάθε φορέα που θα προσφέρεται για χρήση από οποιοδήποτε άλλο σύστημα εντός/εκτός του δημοσίου
  10. Αποθετήριο Εντύπων κάθε Φορέα με πρότυπα έντυπα φορέων και έντυπα αιτήσεωντων οποίων τη συμπλήρωση απαιτούν οι φορείς από τους πολίτες, επιχειρήσεις ή δημοσίους υπαλλήλους.

Τρίτη 10 Ιουνίου : έναρξη του Νέου ΔΙΑΥΓΕΙΑ

Την Τρίτη 10 Ιουνίου 2014 μεταφέρθηκε η έναρξη λειτουργίας του νέου “ΔΙΑΥΓΕΙΑ” για το σύνολο των υπόχρεων φορέων.

Η παράταση δόθηκε με σκοπό την καλύτερη προετοιμασία των Φορέων που χρησιμοποιούν τους μηχανισμούς διασύνδεσης του ΔΙΑΥΓΕΙΑ με τρίτα συστήματα (σύστημα αυτόματων αναρτήσεων και διαλειτουργικότητας).

Το νέο σύστημα είναι τεχνικά και επιχειρησιακά αναβαθμισμένο, προσφέροντας επιπλέον νέα σημαντική λειτουργικότητα. Βασικοί στόχοι είναι η διευκόλυνση των φορέων στην ανάρτηση αποφάσεων αλλά και του πολίτη στην αναζήτηση της πληροφορίας. Παράλληλα συνεχίζει να παρέχει ανοιχτές μεθόδους για την επεξεργασία των στοιχείων που διατηρεί από τρίτα συστήματα.

Για την ομαλή μετάβαση στο νέο ΔΙΑΥΓΕΙΑ:

  • Kαλείστε για το αμέσως επόμενο διάστημα και έως τις 6 Ιουνίου να κάνετε ΔΟΚΙΜΑΣΤΙΚΕΣ ΑΝΑΡΤΗΣΕΙΣ στο πιλοτικό περιβάλλον του νέου “Διαύγεια” https://test3.diavgeia.gov.gr/.
  • Μπορείτε να χρησιμοποιείτε το όνομα χρήστη 10599_2 (δυνατότητα ανάρτησης) με κωδικό πρόσβασης User@10599 ή το όνομα χρήστη 10599_1 (διαχειριστής φορέα) με κωδικό πρόσβασης User@10599.
  • Μπορείτε να αναφέρετε οποιοδήποτε τεχνικό ή επιχειρησιακό ζήτημα στην ηλεκτρονική φόρμα Helpdesk (https://test3.diavgeia.gov.gr/contactForm).

Οι δοκιμαστικές αναρτήσεις που κάνουν οι χρήστες στο πιλοτικό περιβάλλον ΔΕ ΘΑ ΙΣΧΥΟΥΝ. Πριν από την 10η Ιουνίου θα ισχύουν μόνο οι αναρτήσεις που γίνονται στο υφιστάμενο περιβάλλον του ΔΙΑΥΓΕΙΑ.

Εκπαιδευτικό υλικό (εγχειρίδια χρήσης και εκπαιδευτικά βίντεο) μπορείτε να βρείτε στο https://test3.diavgeia.gov.gr/educationalMaterial.

Σημειώνουμε ότι το νέο σύστημα υποστηρίζει ευρέως διαδεδομένους φυλλομετρητές όπως ο Mozilla Firefox, Google Chrome, Internet Explorer (από έκδ. 10 και επόμενες).

Σχετικά με το σύστημα αυτόματων αναρτήσεων και διαλειτουργικότητας (API):

  • Παρακαλούμε ενημερωθείτε στη σχετική ιστοσελίδα https://test3.diavgeia.gov.gr/api/help.
  • Υπενθυμίζουμε ότι από την 10η Ιουνίου και μετά θα λειτουργεί μόνο το νέο σύστημα διαλειτουργικότητας και ότι υπάρχουν δείγματα για την χρήση του API (https://github.com/diavgeia) τα οποία επιδεικνύουν τον τρόπο επικοινωνίας με αυτό σε διάφορες γλώσσες προγραμματισμού.
  • Για οποιοδήποτε τεχνικό πρόβλημα που σχετίζεται με την χρήση του API παρακαλούμε να χρησιμοποιείτε την φόρμα καταγραφής προβλημάτων (https://test3.diavgeia.gov.gr/contactForm)

Σας ευχαριστούμε,

Η ομάδα υποστήριξης του ΔΙΑΥΓΕΙΑ

Δείγματα νέου OpenData API

Προστέθηκαν δείγματα κώδικα διεπαφής με το νέο Opendata API του σύστηματος της Διαύγεια προς διευκόλυνση των ενδιαφερομένων. Τα δείγματα είναι διαθέσιμα στο Github.

Η Υπηρεσία Ανάπτυξης Πληροφορικής (ΥΑΠ) καλέι όλους όσους επιθυμούν (προγραμματιστές , φοιτητές , εταιρίες και οργανισμούς) να στηρίξουν την προσπάθεια αποστέλλοντας δικές τους υλοποιήσεις της διεπαφής σε άλλες γλώσσες προγραμματισμού , μέσω email στην διεύθυνσή api@diavgeia.gov.gr προκειμένου να αναρτηθούν και να γίνουν δημόσια διαθέσιμες.

Νέο Σύστημα Διαύγειας

Την 2η Ιουνίου 2014 θα γίνει η έναρξη της παραγωγικής λειτουργίας του νέου συστήματος “Διαύγεια” για το σύνολο των υπόχρεων φορέων.

Στα πλαίσια διεύρυνσης της διαφάνειας στο Κράτος και σε συνέχεια της τροποποίησης του Ν. 3861/2010, στο επόμενο διάστημα ολοκληρώνεται η ριζική αναβάθμιση του πληροφοριακού συστήματος “Διαύγεια”. Το νέο σύστημα είναι αναβαθμισμένο τεχνικά και επιχειρησιακά σε πολλά σημεία, προσφέροντας επιπλέον νέα σημαντική λειτουργικότητα. Βασικοί στόχοι είναι η διευκόλυνση των φορέων στην ανάρτηση αποφάσεων αλλά και του πολίτη στην αναζήτηση της πληροφορίας, συνεχίζοντας να παρέχει ανοιχτές μεθόδους για την επεξεργασία των στοιχείων που διατηρεί από τρίτα συστήματα.

 

Για την ομαλή μετάβαση στο νέο ΔΙΑΥΓΕΙΑ, καλείστε για το αμέσως επόμενο διάστημα και έως τις 29 Μαΐου να κάνετε ΔΟΚΙΜΑΣΤΙΚΕΣ ΑΝΑΡΤΗΣΕΙΣ, ΚΑΙ στο πιλοτικό περιβάλλον του νέου “Διαύγεια” https://test3.diavgeia.gov.gr/ (Μπορείτε να χρησιμοποιείτε το όνομα χρήστη 10599_2 (δυνατότητα ανάρτησης) με κωδικό πρόσβασης User@10599 ή το όνομα χρήστη 10599_1 (διαχειριστής φορέα) με κωδικό πρόσβασης User@10599) και να αναφέρετε οποιοδήποτε τεχνικό ή επιχειρησιακό ζήτημα στην ηλεκτρονική φόρμα Helpdesk, https://test3.diavgeia.gov.gr/contactForm , (διαθέσιμη μετά τις 20/5/2014).

Οι δοκιμαστικές αναρτήσεις που κάνουν οι χρήστες στο πιλοτικό περιβάλλον ΔΕ ΘΑ ΙΣΧΥΟΥΝ. Πριν από την 2η Ιουνίου θα ισχύουν μόνο οι αναρτήσεις που γίνονται στο υφιστάμενο περιβάλλον του ΔΙΑΥΓΕΙΑ.

Εκπαιδευτικό υλικό (εγχειρίδια χρήσης και εκπαιδευτικά βίντεο) μπορείτε να βρείτε στο https://test3.diavgeia.gov.gr/educationalMaterial .

Για το σύστημα αυτόματων αναρτήσεων και διαλειτουργικότητας παρακαλούμε ενημερωθείτε στην σχετική ιστοσελίδα https://test3.diavgeia.gov.gr/api/help .

Πρόγραμμα ΔΙΑΥΓΕΙΑ

To Πρόγραμμα Δι@ύγεια (νόμος 3861/2010) στοχεύει στην επίτευξη της μέγιστης δυνατής δημοσιότητας της κυβερνητικής πολιτικής και της διοικητικής δραστηριότητας, τη διασφάλιση της διαφάνειας και την εμπέδωση της υπευθυνότητας και της λογοδοσίας από την πλευρά των φορέων άσκησης της δημόσιας εξουσίας.

Μέσω του προγράμματος ΔΙΑΥΓΕΙΑ:

→ Εισάγεται για πρώτη φορά στην Ελλάδα η υποχρέωση ανάρτησης των αποφάσεων των κυβερνητικών οργάνων και της διοίκησης στο Διαδίκτυο

→ Ο Πολίτης μπορεί να έχει πρόσβαση, από ένα σημείο, στο σύνολο των νόμων και αποφάσεων που εκδίδουν τα κυβερνητικά όργανα, οι φορείς του στενού και του ευρύτερου δημόσιου τομέα και οι Ανεξάρτητες Αρχές. Από 15/3/2011 θα ενταχθούν στο Πρόγραμμα Δι@ύγεια και οι Οργανισμοί Τοπικής Αυτοδιοίκησης Α΄ και Β΄ βαθμού

→ Όλες οι αποφάσεις δεν εκτελούνται αν δεν αναρτηθούν στον δικτυακό τόπο et.diavgeia.gov.gr. Mε την ολοκλήρωση της ανάρτησης η κάθε αποφαση αποκτά έναν μοναδικό αριθμό Αριθμό Διαδικτυακής Ανάρτησης (ΑΔΑ), ο οποίος την πιστοποιεί.

Οι λειτουργίες προβολής και αναζήτησης αποφάσεων ανά δημόσιο φορέα παρέχονται μέσω του κεντρικού δικτυακού τόπου του Εθνικού Τυπογραφείου που λειτουργεί στην διεύθυνση et.diavgeia.gov.gr.

Προσχέδιο Νόμου για την Ανάρτηση Αποφάσεων και Πράξεων Κυβερνητικών και Αυτοδιοικητικών Οργάνων καθώς και Οργάνων Διοίκησης Φορέων στο Διαδίκτυο

Με αφορμή το πέρας της δημόσιας διαβούλευσης του Προσχεδίου Νόμου για την «Ανάρτηση Αποφάσεων και Πράξεων Κυβερνητικών και Αυτοδιοικητικών Οργάνων καθώς και Οργάνων Διοίκησης Φορέων στο Διαδίκτυο» επιθυμούμε να ευχαριστήσουμε θερμά όλους τους πολίτες, οι οποίοι ανταποκρινόμενοι στο νέο αυτό θεσμό διάβασαν και σχολίασαν τα άρθρα του σχεδίου νόμου.

Τα σχόλια που έχουν υποβληθεί θα μελετηθούν και θα αναλυθούν, προκειμένου να εξαχθούν χρήσιμα συμπεράσματα για την οριστική διαμόρφωση του νομοσχεδίου. Οι γνώμες και οι απόψεις όλων ανεξαιρέτως των πολιτών είναι σεβαστές και αναγκαίες για να προχωρήσουμε στην εφαρμογή της κυβερνητικής πολιτικής.

Γιάννης Ραγκούσης

Υπουργός Εσωτερικών, Αποκέντρωσης και Ηλεκτρονικής Διακυβέρνησης

ΑΔΑ (ΑΡΙΘΜΟΣ ΔΙΑΔΙΚΤΥΑΚΗΣ ΑΝΑΡΤΗΣΗΣ)

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

Ο κωδικοποιημένος αριθμός παράγεται αλγοριθμικά με βάση την ημερομηνία καταχώρισης, το φορέα και τον αύξοντα αριθμό πράξης του φορέα, εγγράφεται αυτόματα σε κάθε σελίδα του εγγράφου που αναρτάται και πρέπει αναγράφεται πάνω στο σχέδιο κάθε πράξης χειρόγραφα πριν διεκπεραιωθεί.

Είναι η ταυτότητα της κάθε αναρτημένης πράξης και την ακολουθεί εφεξής. Δεν μπορούν να υπάρχουν δύο ΑΔΑ για μια πράξη και όταν μια πράξη για κάποιο λόγο ακυρώνεται ο ΑΔΑ της παραμένει ανενεργός.

Ανακοίνωση : λήψη αρχείου με βάση τον ΑΔΑ

Εάν γνωρίζετε τον ΑΔΑ, μπορείτε εύκολα να “κατεβάσετε” (download) το αρχείο χρησιμοποιώντας τον σύνδεσμο της μορφής “http://static.diavgeia.gov.gr/doc/ΑΔΑ” . Σημειώνεται ότι , σε περίπτωση που έχει ο ΑΔΑ έχει χαρακτήρες, αυτοί θα πρέπει να ειναι στα ελληνικά .

Παράδειγμα :

http://static.diavgeia.gov.gr/doc/Β4Θ0Χ-ΡΩΝ