API
← ΑρχικήAPI Endpoints
Base URL: https://api.ekklesia.gr/api/v1 | 23 listed Modules
Κάθε δημόσια διαδρομή έχει ρητή κατηγορία ορίου. Οι βασικές ροές της εφαρμογής μοιράζονται 1200 αιτήματα/λεπτό/IP, με ξεχωριστό όριο 1200/λεπτό/IP για έλεγχο κατάστασης ZK ανά 5 δευτερόλεπτα. Οι άλλες απλές αναγνώσεις μοιράζονται 120/λεπτό/IP και οι προαιρετικές αναλύσεις, οι κατατάξεις και οι εξαγωγές 20/λεπτό/IP. Η παραγωγή κειμένου μοιράζεται 5/λεπτό/IP και 30/λεπτό συνολικά. Οι υπογεγραμμένες ψήφοι διατηρούν 120/λεπτό/IP· οι έλεγχοι κατάστασης χρησιμοποιούν το όριο βασικών ροών. Η κατάσταση QR επιτρέπει 30/λεπτό ανά έγκυρη συνεδρία και 600/λεπτό/IP. Μόνο ο στατικός χαιρετισμός, το health και το robots εξαιρούνται.
Οι διαδρομές δημόσιων δεδομένων διατηρούν επιπλέον κοινή ποσόστωση 100/λεπτό/IP ή 1000/λεπτό ανά έγκυρο API key. Το κλειδί δεν παρακάμπτει τα όρια αναγνώσεων. Αν η επικύρωση κλειδιού δεν είναι διαθέσιμη, εφαρμόζεται το ανώνυμο όριο IP. Οι διαχειριστικές διαδρομές και τα webhooks έχουν επίσης όρια, πέρα από τον έλεγχο ταυτότητας και επαλήθευσης. Το PayPal επιτρέπει 10/λεπτό/IP, 60/λεπτό συνολικά και τέσσερις ταυτόχρονες επαληθεύσεις ανά διεργασία. Οι εξαγωγές έχουν 100 νομοσχέδια ανά σελίδα (έως 500, offset έως 10.000), το VAA 30 ερωτήσεις (1–100) και οι συνόψεις μόνο γλώσσες el/en.
Οι διεργασίες μοιράζονται τους μετρητές Redis. Σε αστοχία κάθε διεργασία επιτρέπει το μισό όριο, στρογγυλοποιημένο προς τα κάτω με ελάχιστο ένα. Οι εφεδρικοί μετρητές δεν μοιράζονται μεταξύ διεργασιών και έχουν όριο 10.000 ενεργών κάδων· νέοι κάδοι απορρίπτονται με 429 χωρίς διαγραφή ενεργών μετρητών. Τα όρια IP χρησιμοποιούν καθημερινά εναλλασσόμενα HMAC. Οι κεφαλίδες προώθησης γίνονται δεκτές μόνο από έμπιστους διακομιστές μεσολάβησης. Τα αρχεία των περιοριστών περιέχουν μόνο συμβάντα και πλήθη. Ξεχωριστά δεδομένα Redis, κλειδώματα και έλεγχοι κόστους HLR εξακολουθούν να απαιτούν Redis.
Οι απαντήσεις HTTP 429 περιέχουν JSON με error, detail και retry_after και μία αντίστοιχη κεφαλίδα Retry-After σε δευτερόλεπτα. Περιμένετε αυτό το διάστημα πριν από νέα προσπάθεια. Οι επιτρεπόμενες προελεύσεις περιηγητή λαμβάνουν κεφαλίδες CORS που εκθέτουν το Retry-After, καθώς και CSP και nosniff.
| Module | Method | Endpoint | Description |
|---|---|---|---|
| MOD-01 | POST | /identity/verify | HLR έλεγχος κατάστασης ελληνικού αριθμού — δεν αποδεικνύει κατοχή SIM ή ταυτότητα |
| MOD-01 | POST | /identity/revoke | Ανάκληση ταυτότητας |
| MOD-01 | POST | /identity/status | Κατάσταση επαλήθευσης (JSON body: nullifier_hash) |
| MOD-02 | GET | /vaa/statements | 38 Πολιτικές Θέσεις |
| MOD-02 | GET | /vaa/parties | 8 Κόμματα |
| MOD-02 | POST | /vaa/match | Matching αποτέλεσμα |
| MOD-03 | GET | /bills | Λίστα νομοσχεδίων (filter, paginate) |
| MOD-03 | GET | /bills/{id} | Λεπτομέρειες νομοσχεδίου |
| MOD-03 | GET | /bills/trending | Trending ανά relevance score |
| MOD-03 | POST | /bills/{id}/transition | Αλλαγή κατάστασης (admin) |
| MOD-03 | POST | /bills/admin/create | Δημιουργία νομοσχεδίου (admin) |
| MOD-04 | POST | /vote | Καταχώρηση ψήφου (Ed25519 signed) |
| MOD-04 | GET | /vote/{id}/results | Αποτελέσματα + Divergence Score |
| MOD-04 | POST | /vote/{id}/relevance | Relevance Up/Down Signal |
| MOD-06 | GET | /analytics/overview | Πλατφόρμα Στατιστικά |
| MOD-06 | GET | /analytics/divergence-trends | Divergence Trends ανά χρόνο |
| MOD-06 | GET | /analytics/top-divergence | Top Bills ανά Divergence |
| MOD-06 | GET | /analytics/votes-timeline | Χρονική εξέλιξη ψηφοφοριών |
| MOD-06 | GET | /analytics/bill/{id} | Αναλυτικά για ένα Bill |
| MOD-06 | GET | /analytics/info | Analytics Endpoint Docs |
| MOD-07 | GET | /notifications/status | Κατάσταση Notification System |
| MOD-07 | GET | /notifications/stream | SSE Live Stream |
| MOD-07 | WS | /notifications/ws | WebSocket για Mobile |
| MOD-08 | GET | /arweave/status | Arweave Wallet κατάσταση |
| MOD-08 | GET | /arweave/bill/{id} | Arweave TX-ID για Bill |
| MOD-09 | GET | /auth/govgr/status | gov.gr OAuth Activation Gates |
| MOD-09 | GET | /auth/govgr/login | OAuth Login (Stub) |
| MOD-09 | GET | /auth/govgr/callback | OAuth Callback (Stub) |
| MOD-09 | GET | /auth/govgr/family/verify | Liquid Democracy Stub |
| MOD-09 | GET | /auth/govgr/info | gov.gr Docs |
| MOD-10 | GET | /scraper/status | AI Scraper Provider Status |
| MOD-10 | GET | /scraper/test | Scraper Test ohne DB |
| MOD-10 | GET | /scraper/parliament/latest | Scrape hellenicparliament.gr |
| MOD-10 | POST | /scraper/fetch | Scrape + AI → DB (admin) |
| MOD-11 | GET | /public/info | Public API Docs |
| MOD-11 | GET | /public/stats | Πλατφόρμα Στατιστικά (public) |
| MOD-11 | GET | /public/bills | Bills (CC BY 4.0) |
| MOD-11 | GET | /public/bills/{id}/results | Αποτελέσματα (public) |
| MOD-11 | GET | /public/vaa/parties | Parteien (public) |
| MOD-24 | GET | /public/cplm | CPLM — Πολιτικός Καθρέφτης (X/Y) |
| MOD-24 | GET | /public/cplm/history | CPLM Ιστορικά Snapshots |
| MOD-24 | GET | /public/representation | Αντιπροσωπευτικότητα Βουλής |
| MOD-11 | POST | /public/keys/generate | API Key (kein Konto nötig) |
| MOD-11 | GET | /public/keys/status | API Key Status |
| MOD-12 | GET | /mp/parties | Κόμματα με Παρλαμεντική Παρουσία |
| MOD-12 | GET | /mp/ranking | Ranking Σύγκλισης με Πολίτες |
| MOD-12 | GET | /mp/compare/{abbr} | Κόμμα vs Πλειοψηφία Πολιτών |
| MOD-12 | GET | /mp/bill/{id} | Κομματικές Ψήφοι για Bill |
| MOD-12 | GET | /mp/info | MP Comparison Docs |
| MOD-14 | GET | /export/info | Export Endpoint Docs |
| MOD-14 | GET | /export/bills.csv | Bills + Αποτελέσματα CSV |
| MOD-14 | GET | /export/results.json | Αποτελέσματα JSON |
| MOD-14 | GET | /export/divergence.csv | Divergence Ranking CSV |
| MOD-14 | GET | /export/parties.json | Κόμματα JSON |
| MOD-15 | GET | /admin/dashboard | Admin Dashboard |
| MOD-15 | GET | /admin/bills | Admin Bills Liste |
| MOD-15 | POST | /admin/bills | Νέο Bill δημιουργία |
| MOD-15 | PATCH | /admin/bills/{id} | Bill ενημέρωση |
| MOD-15 | POST | /admin/bills/{id}/review | AI Summary Review |
| MOD-15 | POST | /admin/bills/{id}/party-votes | Κομματικές Ψήφοι setzen |
| MOD-15 | GET | /admin/stats | Admin Στατιστικά |
| MOD-15 | POST | /notifications/test/publish | Test Event publish |
| MOD-16 | GET | /periferia | 13 Περιφέρειες |
| MOD-16 | GET | /periferia/{id}/dimos | Δήμοι Περιφέρειας |
| MOD-16 | GET | /decisions | Αποφάσεις (φίλτρο) |
| MOD-21 | GET | /municipal/{id}/decisions | Diavgeia Αποφάσεις Δήμου |
| MOD-21 | GET | /regions/{id}/decisions | Diavgeia Αποφάσεις Περιφέρειας |
| MOD-21 | POST | /admin/diavgeia/scrape | Manual Scrape (Admin) |
| MOD-21 | POST | /admin/diavgeia/refresh-orgs-cache | Org Cache Refresh (Admin) |
| MOD-21 | GET | /scraper/jobs | Scraper Job Status (Redis) |
| MOD-21 | GET | /consensus/representation | Συγκεντρωτικά αποτελέσματα Διαύγειας ανά γεωγραφικό επίπεδο |
| MOD-22 | POST | /agent/ask | RAG Agent — Ερωτήσεις και απαντήσεις πολιτών (5 req/min) |
| MOD-22 | GET | /bills/{id}/summary | Περίληψη νομοσχεδίου με AI (Redis cache 7d) |
| MOD-22 | POST | /admin/logs/explain | Ανάλυση αρχείων καταγραφής με AI (Admin) |
| MOD-22 | POST | /admin/scraper/heal-status | Auto-Healing Status (Admin) |
| MOD-19 | POST | /newsletter/subscribe | Newsletter Εγγραφή |
| MOD-19 | GET | /newsletter/stats | Newsletter Στατιστικά |
| MOD-20 | POST | /notify/register | Push Token Εγγραφή |
| MOD-25 | GET | /politicians/ | Λίστα εκπροσώπων που ενεργοποίησαν την αξιολόγηση |
| MOD-25 | GET | /politicians/{ada_number}/questions | Ερωτήσεις αξιολόγησης |
| MOD-25 | POST | /politicians/{ada_number}/evaluate | Υποβολή αξιολόγησης (-5 έως +5 ανά ερώτηση, Ed25519 signed) |
| MOD-25 | GET | /politicians/{ada_number}/my-evaluation | Η αξιολόγησή μου |
| MOD-25 | GET | /politicians/{ada_number}/scores | Δημόσια αποτελέσματα αξιολόγησης |
| MOD-25 | POST | /rep/enable-evaluation | Συγκατάθεση εκπροσώπου για αξιολόγηση (εκπρόσωπος app) |
| MOD-25 | GET | /rep/my-scores | Αποτελέσματα αξιολόγησης εκπροσώπου (εκπρόσωπος app) |