Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\"\n }\n }\n]" } ] }, { "name": "Διαβουλεύσεις ανά φορέα", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/subsite-posts?site_id=5", "host": [ "{{base_url}}" ], "path": [ "subsite-posts" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (βλ. πίνακα Site IDs)", "disabled": false }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τις δημοσιευμένες διαβουλεύσεις ενός συγκεκριμένου φορέα (Υπουργείου ή άλλης αρχής). Απαιτείται η παράμετρος `site_id` — χρησιμοποιήστε τον πίνακα Site IDs για να βρείτε το ID του φορέα που σας ενδιαφέρει." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/subsite-posts?site_id=5", "host": [ "{{base_url}}" ], "path": [ "subsite-posts" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (βλ. πίνακα Site IDs)", "disabled": false }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τις δημοσιευμένες διαβουλεύσεις ενός συγκεκριμένου φορέα (Υπουργείου ή άλλης αρχής). Απαιτείται η παράμετρος `site_id` — χρησιμοποιήστε τον πίνακα Site IDs για να βρείτε το ID του φορέα που σας ενδιαφέρει." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός διαβουλεύσεων του φορέα" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 1234,\n \"title\": \"Σχέδιο νόμου για...\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"excerpt\": \"Σύντομη περιγραφή...\",\n \"content\": \"
Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\"\n }\n }\n]" } ] }, { "name": "Λεπτομέρειες μιας διαβούλευσης", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "post", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (βλ. πίνακα Site IDs παρακάτω) — τα post IDs δεν είναι globally unique σε multisite", "disabled": false } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει όλα τα στοιχεία μιας συγκεκριμένης διαβούλευσης βάσει του αναγνωριστικού της (`id`). Σε multisite περιβάλλον **συνιστάται ανεπιφύλακτα** η χρήση `site_id`: τα post IDs δεν είναι globally unique στο WordPress multisite, οπότε χωρίς `site_id` το σύστημα επιστρέφει την πρώτη διαβούλευση που βρίσκει με αυτό το ID σε οποιονδήποτε φορέα." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "post", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (βλ. πίνακα Site IDs παρακάτω) — τα post IDs δεν είναι globally unique σε multisite", "disabled": false } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει όλα τα στοιχεία μιας συγκεκριμένης διαβούλευσης βάσει του αναγνωριστικού της (`id`). Σε multisite περιβάλλον **συνιστάται ανεπιφύλακτα** η χρήση `site_id`: τα post IDs δεν είναι globally unique στο WordPress multisite, οπότε χωρίς `site_id` το σύστημα επιστρέφει την πρώτη διαβούλευση που βρίσκει με αυτό το ID σε οποιονδήποτε φορέα." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"id\": 1234,\n \"title\": \"Σχέδιο νόμου για...\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"excerpt\": \"Σύντομη περιγραφή...\",\n \"content\": \"
Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\"\n }\n}" } ] }, { "name": "Εκτεταμένες λεπτομέρειες διαβούλευσης", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/deliberation/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "deliberation", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα", "disabled": false } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει πλούσιο αντικείμενο με όλα τα πεδία ACF, την κατάσταση (ανοικτή/κλειστή), τον συνολικό αριθμό σχολίων και το endpoint για την ανάκτησή τους. Ιδανικό για εφαρμογές που χρειάζονται πλήρη μεταδεδομένα της διαβούλευσης." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/deliberation/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "deliberation", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα", "disabled": false } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει πλούσιο αντικείμενο με όλα τα πεδία ACF, την κατάσταση (ανοικτή/κλειστή), τον συνολικό αριθμό σχολίων και το endpoint για την ανάκτησή τους. Ιδανικό για εφαρμογές που χρειάζονται πλήρη μεταδεδομένα της διαβούλευσης." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"id\": 1234,\n \"site_id\": 5,\n \"title\": \"Σχέδιο νόμου για...\",\n \"status\": [\n \"open\"\n ],\n \"publish_date\": \"2024-03-15 12:30:00\",\n \"acf\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\",\n \"type\": \"nomosxedia\"\n },\n \"comments\": {\n \"total\": 47,\n \"endpoint\": \"https:\\/\\/www.opengov.gr\\/wp-json\\/opengov\\/v1\\/post\\/1234\\/comments?site_id=5\"\n },\n \"raw_post\": {\n \"ID\": 1234,\n \"post_title\": \"Σχέδιο νόμου για...\",\n \"post_status\": \"publish\",\n \"post_type\": \"deliberations\",\n \"post_date\": \"2024-03-15 12:30:00\"\n }\n}" } ] }, { "name": "Ανοικτές διαβουλεύσεις δικτύου", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/open-deliberations", "host": [ "{{base_url}}" ], "path": [ "open-deliberations" ], "query": [ { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει όλες τις τρέχουσες ανοικτές διαβουλεύσεις σε όλο το δίκτυο, ταξινομημένες κατά ημερομηνία λήξης (η πλησιέστερη προς λήξη πρώτη). Χρήσιμο για να δείτε τι είναι ανοικτό προς σχολιασμό αυτή τη στιγμή, χωρίς να χρειάζεται να τραβήξετε και να φιλτράρετε όλο το `/all-posts`." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/open-deliberations", "host": [ "{{base_url}}" ], "path": [ "open-deliberations" ], "query": [ { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει όλες τις τρέχουσες ανοικτές διαβουλεύσεις σε όλο το δίκτυο, ταξινομημένες κατά ημερομηνία λήξης (η πλησιέστερη προς λήξη πρώτη). Χρήσιμο για να δείτε τι είναι ανοικτό προς σχολιασμό αυτή τη στιγμή, χωρίς να χρειάζεται να τραβήξετε και να φιλτράρετε όλο το `/all-posts`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός ανοικτών διαβουλεύσεων" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 1234,\n \"title\": \"Σχέδιο νόμου για τη βελτίωση της δημόσιας διοίκησης\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"excerpt\": \"Σύντομη περιγραφή...\",\n \"content\": \"
Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\"\n }\n }\n]" } ] }, { "name": "Διαβουλεύσεις που κλείνουν σύντομα", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/closing-soon", "host": [ "{{base_url}}" ], "path": [ "closing-soon" ], "query": [ { "key": "days", "value": "7", "description": "Διαβουλεύσεις που κλείνουν εντός τόσων ημερών (1–90)", "disabled": true }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τις ανοικτές διαβουλεύσεις των οποίων η ημερομηνία λήξης πέφτει εντός των επόμενων `days` ημερών, σε όλο το δίκτυο. Ταξινομημένες κατά ημερομηνία λήξης (η πλησιέστερη πρώτη)." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/closing-soon", "host": [ "{{base_url}}" ], "path": [ "closing-soon" ], "query": [ { "key": "days", "value": "7", "description": "Διαβουλεύσεις που κλείνουν εντός τόσων ημερών (1–90)", "disabled": true }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τις ανοικτές διαβουλεύσεις των οποίων η ημερομηνία λήξης πέφτει εντός των επόμενων `days` ημερών, σε όλο το δίκτυο. Ταξινομημένες κατά ημερομηνία λήξης (η πλησιέστερη πρώτη)." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός διαβουλεύσεων που κλείνουν σύντομα" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 1234,\n \"title\": \"Σχέδιο νόμου για...\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"excerpt\": \"Σύντομη περιγραφή...\",\n \"content\": \"
Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-03-20 23:59:00\"\n }\n }\n]" } ] }, { "name": "Αναζήτηση διαβουλεύσεων", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/search?q=%CE%B4%CE%B7%CE%BC%CF%8C%CF%83%CE%B9%CE%B1%20%CE%B4%CE%B9%CE%BF%CE%AF%CE%BA%CE%B7%CF%83%CE%B7", "host": [ "{{base_url}}" ], "path": [ "search" ], "query": [ { "key": "q", "value": "δημόσια διοίκηση", "description": "Λέξη ή φράση αναζήτησης", "disabled": false }, { "key": "site_id", "value": "5", "description": "Περιορισμός αναζήτησης σε συγκεκριμένο φορέα", "disabled": true }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Αναζητά διαβουλεύσεις με βάση λέξη-κλειδί στον τίτλο και το περιεχόμενο. Από προεπιλογή ψάχνει σε όλο το δίκτυο· με την προαιρετική παράμετρο `site_id` μπορείτε να περιορίσετε την αναζήτηση σε έναν συγκεκριμένο φορέα. Τα αποτελέσματα ταξινομούνται χρονολογικά (νεότερα πρώτα)." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/search?q=%CE%B4%CE%B7%CE%BC%CF%8C%CF%83%CE%B9%CE%B1%20%CE%B4%CE%B9%CE%BF%CE%AF%CE%BA%CE%B7%CF%83%CE%B7", "host": [ "{{base_url}}" ], "path": [ "search" ], "query": [ { "key": "q", "value": "δημόσια διοίκηση", "description": "Λέξη ή φράση αναζήτησης", "disabled": false }, { "key": "site_id", "value": "5", "description": "Περιορισμός αναζήτησης σε συγκεκριμένο φορέα", "disabled": true }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "10", "description": "Αποτελέσματα ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Αναζητά διαβουλεύσεις με βάση λέξη-κλειδί στον τίτλο και το περιεχόμενο. Από προεπιλογή ψάχνει σε όλο το δίκτυο· με την προαιρετική παράμετρο `site_id` μπορείτε να περιορίσετε την αναζήτηση σε έναν συγκεκριμένο φορέα. Τα αποτελέσματα ταξινομούνται χρονολογικά (νεότερα πρώτα)." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός αποτελεσμάτων" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 1234,\n \"title\": \"Σχέδιο νόμου για τη βελτίωση της δημόσιας διοίκησης\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"excerpt\": \"Σύντομη περιγραφή...\",\n \"content\": \"
Πλήρες κείμενο...<\\/p>\",\n \"date_gmt\": \"2024-03-15 10:30:00\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"acf_fields\": {\n \"publish_date\": \"2024-03-15 10:30:00\",\n \"expiry_date\": \"2024-04-15 23:59:00\"\n }\n }\n]" } ] } ] }, { "name": "Σχόλια", "item": [ { "name": "Σχόλια διαβούλευσης", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id/comments?site_id=5", "host": [ "{{base_url}}" ], "path": [ "post", ":id", "comments" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα", "disabled": false }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "20", "description": "Σχόλια ανά σελίδα (μέγιστο 200)", "disabled": true } ], "variable": [ { "key": "id", "value": "1234", "description": "ID της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει τα εγκεκριμένα σχόλια μιας διαβούλευσης σε σελιδοποιημένη μορφή. Τα σχόλια ταξινομούνται χρονολογικά (παλαιότερα πρώτα). Το πεδίο `author` εμφανίζει το πλήρες όνομα μόνο αν ο χρήστης το έχει επιτρέψει — διαφορετικά εμφανίζεται «Ανώνυμος χρήστης». Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του συγκεκριμένου σχολίου. Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (θα είναι `null` για γενικά σχόλια χωρίς σύνδεση με συγκεκριμένο άρθρο)." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id/comments?site_id=5", "host": [ "{{base_url}}" ], "path": [ "post", ":id", "comments" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα", "disabled": false }, { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "20", "description": "Σχόλια ανά σελίδα (μέγιστο 200)", "disabled": true } ], "variable": [ { "key": "id", "value": "1234", "description": "ID της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει τα εγκεκριμένα σχόλια μιας διαβούλευσης σε σελιδοποιημένη μορφή. Τα σχόλια ταξινομούνται χρονολογικά (παλαιότερα πρώτα). Το πεδίο `author` εμφανίζει το πλήρες όνομα μόνο αν ο χρήστης το έχει επιτρέψει — διαφορετικά εμφανίζεται «Ανώνυμος χρήστης». Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του συγκεκριμένου σχολίου. Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (θα είναι `null` για γενικά σχόλια χωρίς σύνδεση με συγκεκριμένο άρθρο)." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός σχολίων της διαβούλευσης" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 456,\n \"post_id\": 1234,\n \"article_unique_id\": \"abc123-def456-ghi789\",\n \"article_title\": \"Άρθρο 3 - Πεδίο εφαρμογής\",\n \"author\": \"Ανώνυμος χρήστης\",\n \"author_url\": \"\",\n \"user_id\": 0,\n \"date\": \"2024-03-20 14:25:00\",\n \"date_gmt\": \"2024-03-20 12:25:00\",\n \"content\": \"
Προτείνω να προστεθεί διάταξη για...<\\/p>\",\n \"approved\": 1,\n \"parent\": 0,\n \"type\": \"\",\n \"comment_url\": \"https:\\/\\/www.opengov.gr\\/comment-view\\/?cid=456&sid=5\",\n \"meta\": {\n \"show_full_name\": \"0\"\n }\n }\n]" } ] }, { "name": "Λεπτομέρειες σχολίου", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/comment/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "comment", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα όπου ανήκει το σχόλιο", "disabled": false } ], "variable": [ { "key": "id", "value": "456", "description": "Αναγνωριστικό (ID) του σχολίου (στο URL path)" } ] }, "description": "Επιστρέφει τα πλήρη στοιχεία ενός μεμονωμένου σχολίου, συμπεριλαμβανομένων όλων των μεταδεδομένων (`meta`). Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (`null` αν είναι γενικό σχόλιο). Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του σχολίου." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/comment/:id?site_id=5", "host": [ "{{base_url}}" ], "path": [ "comment", ":id" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα όπου ανήκει το σχόλιο", "disabled": false } ], "variable": [ { "key": "id", "value": "456", "description": "Αναγνωριστικό (ID) του σχολίου (στο URL path)" } ] }, "description": "Επιστρέφει τα πλήρη στοιχεία ενός μεμονωμένου σχολίου, συμπεριλαμβανομένων όλων των μεταδεδομένων (`meta`). Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (`null` αν είναι γενικό σχόλιο). Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του σχολίου." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"id\": 456,\n \"post_id\": 1234,\n \"article_unique_id\": \"abc123-def456-ghi789\",\n \"article_title\": \"Άρθρο 3 - Πεδίο εφαρμογής\",\n \"site_id\": 5,\n \"author\": \"Γιώργος Παπαδόπουλος\",\n \"date\": \"2024-03-20 14:25:00\",\n \"date_gmt\": \"2024-03-20 12:25:00\",\n \"content\": \"
Προτείνω να προστεθεί διάταξη για...<\\/p>\",\n \"approved\": 1,\n \"comment_url\": \"https:\\/\\/www.opengov.gr\\/comment-view\\/?cid=456&sid=5\",\n \"meta\": {\n \"show_full_name\": \"1\",\n \"article_unique_id\": \"abc123-def456-ghi789\"\n }\n}" } ] }, { "name": "Πρόσφατα σχόλια δικτύου", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/recent-comments", "host": [ "{{base_url}}" ], "path": [ "recent-comments" ], "query": [ { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "20", "description": "Σχόλια ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τα πιο πρόσφατα εγκεκριμένα σχόλια σε όλο το δίκτυο — ένα feed δραστηριότητας με τίτλο και σύνδεσμο της διαβούλευσης στην οποία ανήκει κάθε σχόλιο. Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (`null` αν είναι γενικό σχόλιο). Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του ίδιου του σχολίου (όχι της διαβούλευσης)." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/recent-comments", "host": [ "{{base_url}}" ], "path": [ "recent-comments" ], "query": [ { "key": "page", "value": "1", "description": "Αριθμός σελίδας", "disabled": true }, { "key": "per_page", "value": "20", "description": "Σχόλια ανά σελίδα (μέγιστο 100)", "disabled": true } ] }, "description": "Επιστρέφει τα πιο πρόσφατα εγκεκριμένα σχόλια σε όλο το δίκτυο — ένα feed δραστηριότητας με τίτλο και σύνδεσμο της διαβούλευσης στην οποία ανήκει κάθε σχόλιο. Τα πεδία `article_unique_id` και `article_title` δείχνουν σε ποιο άρθρο/ενότητα της διαβούλευσης ανήκει το σχόλιο (`null` αν είναι γενικό σχόλιο). Το πεδίο `comment_url` δείχνει στη σελίδα προβολής του ίδιου του σχολίου (όχι της διαβούλευσης)." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός σχολίων που καλύπτει η σελιδοποίηση" }, { "key": "X-WP-TotalPages", "value": "1", "description": "Συνολικός αριθμός σελίδων" } ], "cookie": [], "body": "[\n {\n \"id\": 456,\n \"post_id\": 1234,\n \"article_unique_id\": \"abc123-def456-ghi789\",\n \"article_title\": \"Άρθρο 3 - Πεδίο εφαρμογής\",\n \"post_title\": \"Σχέδιο νόμου για...\",\n \"permalink\": \"https:\\/\\/www.opengov.gr\\/ypes\\/deliberations\\/sxedio-nomou-gia-ti-veltiosi-tis-dimosias-dioikisis\\/\",\n \"comment_url\": \"https:\\/\\/www.opengov.gr\\/comment-view\\/?cid=456&sid=5\",\n \"site_id\": 5,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"author\": \"Ανώνυμος χρήστης\",\n \"date_gmt\": \"2024-03-20 12:25:00\",\n \"content\": \"
Προτείνω να προστεθεί διάταξη για...<\\/p>\"\n }\n]" } ] } ] }, { "name": "Φορείς", "item": [ { "name": "Πληροφορίες φορέα", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/site-info?site_id=5", "host": [ "{{base_url}}" ], "path": [ "site-info" ], "query": [ { "key": "site_id", "value": "5", "description": "Αναγνωριστικό (ID) του φορέα", "disabled": false } ] }, "description": "Επιστρέφει βασικές πληροφορίες για έναν φορέα του δικτύου: όνομα, URL, περιγραφή, αριθμό δημοσιευμένων διαβουλεύσεων, κωδικό φορέα και τύπο οντότητας." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/site-info?site_id=5", "host": [ "{{base_url}}" ], "path": [ "site-info" ], "query": [ { "key": "site_id", "value": "5", "description": "Αναγνωριστικό (ID) του φορέα", "disabled": false } ] }, "description": "Επιστρέφει βασικές πληροφορίες για έναν φορέα του δικτύου: όνομα, URL, περιγραφή, αριθμό δημοσιευμένων διαβουλεύσεων, κωδικό φορέα και τύπο οντότητας." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"site_id\": 5,\n \"name\": \"Υπουργείο Εσωτερικών\",\n \"url\": \"https:\\/\\/www.opengov.gr\\/ypes\",\n \"description\": \"Ηλεκτρονική Δημόσια Διαβούλευση\",\n \"deliberations_count\": 42,\n \"code\": 1035,\n \"kind\": \"ministry\"\n}" } ] }, { "name": "Λίστα φορέων", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/organizations", "host": [ "{{base_url}}" ], "path": [ "organizations" ] }, "description": "Επιστρέφει λίστα με όλους τους ενεργούς φορείς (Υπουργεία και άλλες αρχές) του δικτύου, μαζί με το `site_id`, το όνομα, τον κωδικό, το URL, τον τύπο οντότητας και τον αριθμό δημοσιευμένων διαβουλεύσεων του κάθε φορέα. Χρήσιμο για την εύρεση των `site_id` που απαιτούνται σε άλλα endpoints." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/organizations", "host": [ "{{base_url}}" ], "path": [ "organizations" ] }, "description": "Επιστρέφει λίστα με όλους τους ενεργούς φορείς (Υπουργεία και άλλες αρχές) του δικτύου, μαζί με το `site_id`, το όνομα, τον κωδικό, το URL, τον τύπο οντότητας και τον αριθμό δημοσιευμένων διαβουλεύσεων του κάθε φορέα. Χρήσιμο για την εύρεση των `site_id` που απαιτούνται σε άλλα endpoints." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-WP-Total", "value": "1", "description": "Συνολικός αριθμός φορέων" } ], "cookie": [], "body": "[\n {\n \"site_id\": 5,\n \"name\": \"Υπουργείο Εσωτερικών\",\n \"url\": \"https:\\/\\/www.opengov.gr\\/ypes\",\n \"description\": \"Ηλεκτρονική Δημόσια Διαβούλευση\",\n \"deliberations_count\": 42,\n \"code\": 1035,\n \"kind\": \"ministry\"\n }\n]" } ] }, { "name": "Τύποι φορέων", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/organization-kinds", "host": [ "{{base_url}}" ], "path": [ "organization-kinds" ] }, "description": "Επιστρέφει τους διακριτούς τύπους φορέων (π.χ. `ministry`, `independent_authority`) που χρησιμοποιούνται στο δίκτυο, μαζί με τον αριθμό φορέων ανά τύπο. Χρήσιμο για την κατασκευή φίλτρων πάνω στο `/organizations`." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/organization-kinds", "host": [ "{{base_url}}" ], "path": [ "organization-kinds" ] }, "description": "Επιστρέφει τους διακριτούς τύπους φορέων (π.χ. `ministry`, `independent_authority`) που χρησιμοποιούνται στο δίκτυο, μαζί με τον αριθμό φορέων ανά τύπο. Χρήσιμο για την κατασκευή φίλτρων πάνω στο `/organizations`." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "[\n {\n \"kind\": \"ministry\",\n \"count\": 18\n },\n {\n \"kind\": \"independent_authority\",\n \"count\": 4\n }\n]" } ] } ] }, { "name": "Συνημμένα", "item": [ { "name": "Συνημμένα διαβούλευσης", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id/attachments", "host": [ "{{base_url}}" ], "path": [ "post", ":id", "attachments" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (προαιρετικό, βελτιώνει ταχύτητα/ακρίβεια)", "disabled": true } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει τα συνημμένα αρχεία (π.χ. PDF) μιας διαβούλευσης. Αν παραλειφθεί το `site_id`, γίνεται αναζήτηση σε όλους τους φορείς — συνιστάται όμως η χρήση του για ταχύτητα και ακρίβεια, αφού τα post IDs δεν είναι globally unique σε multisite." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/post/:id/attachments", "host": [ "{{base_url}}" ], "path": [ "post", ":id", "attachments" ], "query": [ { "key": "site_id", "value": "5", "description": "ID του φορέα (προαιρετικό, βελτιώνει ταχύτητα/ακρίβεια)", "disabled": true } ], "variable": [ { "key": "id", "value": "1234", "description": "Αναγνωριστικό (ID) της διαβούλευσης (στο URL path)" } ] }, "description": "Επιστρέφει τα συνημμένα αρχεία (π.χ. PDF) μιας διαβούλευσης. Αν παραλειφθεί το `site_id`, γίνεται αναζήτηση σε όλους τους φορείς — συνιστάται όμως η χρήση του για ταχύτητα και ακρίβεια, αφού τα post IDs δεν είναι globally unique σε multisite." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "[\n {\n \"id\": 789,\n \"label\": \"Σχέδιο νόμου (πλήρες κείμενο)\",\n \"filename\": \"nomosxedio.pdf\",\n \"url\": \"https:\\/\\/www.opengov.gr\\/wp-content\\/uploads\\/sites\\/5\\/2024\\/03\\/nomosxedio.pdf\",\n \"mime_type\": \"application\\/pdf\"\n }\n]" } ] } ] }, { "name": "Στατιστικά", "item": [ { "name": "Στατιστικά & Αναλυτικά", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/analytics", "host": [ "{{base_url}}" ], "path": [ "analytics" ], "query": [ { "key": "site_id[]", "value": "2", "description": "ID φορέα — μπορεί να επαναληφθεί για πολλούς φορείς (π.χ. site_id[]=2&site_id[]=5)", "disabled": true }, { "key": "start_date", "value": "2024-01-01", "description": "Αρχή φίλτρου ημερομηνίας (Y-m-d). Εφαρμόζεται σε σχόλια και ημερομηνία δημοσίευσης διαβούλευσης", "disabled": true }, { "key": "end_date", "value": "2024-12-31", "description": "Τέλος φίλτρου ημερομηνίας (Y-m-d), συμπεριλαμβανόμενο", "disabled": true } ] }, "description": "Επιστρέφει αθροιστικά στατιστικά για ένα ή περισσότερα sites του δικτύου. Περιλαμβάνει σύνολα σχολίων (εγκεκριμένα/απορριφθέντα/υποβληθέντα), κατανομή μήκους σχολίων, χρήστες, κατάσταση διαβουλεύσεων, top-10 διαβουλεύσεις και μέσους όρους. Τα αποτελέσματα ανανεώνονται κάθε 5 λεπτά (cache). Η κεφαλίδα `X-Cache: HIT/MISS` δείχνει αν η απόκριση ήρθε από cache." }, "response": [ { "name": "200 OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/analytics", "host": [ "{{base_url}}" ], "path": [ "analytics" ], "query": [ { "key": "site_id[]", "value": "2", "description": "ID φορέα — μπορεί να επαναληφθεί για πολλούς φορείς (π.χ. site_id[]=2&site_id[]=5)", "disabled": true }, { "key": "start_date", "value": "2024-01-01", "description": "Αρχή φίλτρου ημερομηνίας (Y-m-d). Εφαρμόζεται σε σχόλια και ημερομηνία δημοσίευσης διαβούλευσης", "disabled": true }, { "key": "end_date", "value": "2024-12-31", "description": "Τέλος φίλτρου ημερομηνίας (Y-m-d), συμπεριλαμβανόμενο", "disabled": true } ] }, "description": "Επιστρέφει αθροιστικά στατιστικά για ένα ή περισσότερα sites του δικτύου. Περιλαμβάνει σύνολα σχολίων (εγκεκριμένα/απορριφθέντα/υποβληθέντα), κατανομή μήκους σχολίων, χρήστες, κατάσταση διαβουλεύσεων, top-10 διαβουλεύσεις και μέσους όρους. Τα αποτελέσματα ανανεώνονται κάθε 5 λεπτά (cache). Η κεφαλίδα `X-Cache: HIT/MISS` δείχνει αν η απόκριση ήρθε από cache." }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" }, { "key": "X-Cache", "value": "MISS", "description": "HIT αν η απόκριση προήλθε από cache, MISS αν υπολογίστηκε εκ νέου" } ], "cookie": [], "body": "{\n \"meta\": {\n \"site_ids\": [\n 2,\n 5\n ],\n \"start_date\": \"2024-01-01\",\n \"end_date\": \"2024-12-31\",\n \"generated_at\": \"2024-12-31T23:00:00Z\",\n \"cache_ttl_seconds\": 300\n },\n \"comments\": {\n \"approved\": 12540,\n \"rejected\": 430,\n \"submitted\": 12970,\n \"length_distribution\": {\n \"0-50\": 3200,\n \"51-100\": 4800,\n \"101-200\": 3500,\n \"201+\": 1040\n },\n \"per_site\": [\n {\n \"site_id\": 2,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"approved_comments\": 7200,\n \"rejected_comments\": 210,\n \"submitted_comments\": 7410,\n \"open_deliberations\": 3,\n \"closed_deliberations\": 18,\n \"unique_commenters\": 1840,\n \"engagement_ratio_percent\": 11.93\n }\n ]\n },\n \"users\": {\n \"total_registered\": 15420,\n \"unique_commenters\": 3240,\n \"engagement_ratio_percent\": 21.01\n },\n \"deliberations\": {\n \"total\": 156,\n \"open\": 12,\n \"closed\": 144,\n \"without_comments\": 8,\n \"without_comments_percent\": 5.13,\n \"per_site\": [\n {\n \"site_id\": 2,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"open\": 3,\n \"closed\": 18\n }\n ]\n },\n \"top_by_comments\": [\n {\n \"post_id\": 1234,\n \"title\": \"Σχέδιο νόμου για...\",\n \"comments\": 842,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"site_id\": 2,\n \"duration_days\": 30\n }\n ],\n \"top_by_engagement\": [\n {\n \"post_id\": 1234,\n \"title\": \"Σχέδιο νόμου για...\",\n \"comments\": 842,\n \"site_name\": \"Υπουργείο Εσωτερικών\",\n \"site_id\": 2,\n \"duration_days\": 30,\n \"comments_per_day\": 28.07\n }\n ],\n \"averages\": {\n \"comments_per_deliberation\": 80.38,\n \"comments_per_registered_user\": 0.8132,\n \"avg_deliberation_duration_days\": 27.4\n }\n}" } ] } ] } ] }