Μετάβαση στο κύριο περιεχόμενο

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.

Πλήρης πολιτική ανά διαδρομή και αιτιολόγηση εξαιρέσεων

ModuleMethodEndpointDescription
MOD-01POST/identity/verifyHLR έλεγχος κατάστασης ελληνικού αριθμού — δεν αποδεικνύει κατοχή SIM ή ταυτότητα
MOD-01POST/identity/revokeΑνάκληση ταυτότητας
MOD-01POST/identity/statusΚατάσταση επαλήθευσης (JSON body: nullifier_hash)
MOD-02GET/vaa/statements38 Πολιτικές Θέσεις
MOD-02GET/vaa/parties8 Κόμματα
MOD-02POST/vaa/matchMatching αποτέλεσμα
MOD-03GET/billsΛίστα νομοσχεδίων (filter, paginate)
MOD-03GET/bills/{id}Λεπτομέρειες νομοσχεδίου
MOD-03GET/bills/trendingTrending ανά relevance score
MOD-03POST/bills/{id}/transitionΑλλαγή κατάστασης (admin)
MOD-03POST/bills/admin/createΔημιουργία νομοσχεδίου (admin)
MOD-04POST/voteΚαταχώρηση ψήφου (Ed25519 signed)
MOD-04GET/vote/{id}/resultsΑποτελέσματα + Divergence Score
MOD-04POST/vote/{id}/relevanceRelevance Up/Down Signal
MOD-06GET/analytics/overviewΠλατφόρμα Στατιστικά
MOD-06GET/analytics/divergence-trendsDivergence Trends ανά χρόνο
MOD-06GET/analytics/top-divergenceTop Bills ανά Divergence
MOD-06GET/analytics/votes-timelineΧρονική εξέλιξη ψηφοφοριών
MOD-06GET/analytics/bill/{id}Αναλυτικά για ένα Bill
MOD-06GET/analytics/infoAnalytics Endpoint Docs
MOD-07GET/notifications/statusΚατάσταση Notification System
MOD-07GET/notifications/streamSSE Live Stream
MOD-07WS/notifications/wsWebSocket για Mobile
MOD-08GET/arweave/statusArweave Wallet κατάσταση
MOD-08GET/arweave/bill/{id}Arweave TX-ID για Bill
MOD-09GET/auth/govgr/statusgov.gr OAuth Activation Gates
MOD-09GET/auth/govgr/loginOAuth Login (Stub)
MOD-09GET/auth/govgr/callbackOAuth Callback (Stub)
MOD-09GET/auth/govgr/family/verifyLiquid Democracy Stub
MOD-09GET/auth/govgr/infogov.gr Docs
MOD-10GET/scraper/statusAI Scraper Provider Status
MOD-10GET/scraper/testScraper Test ohne DB
MOD-10GET/scraper/parliament/latestScrape hellenicparliament.gr
MOD-10POST/scraper/fetchScrape + AI → DB (admin)
MOD-11GET/public/infoPublic API Docs
MOD-11GET/public/statsΠλατφόρμα Στατιστικά (public)
MOD-11GET/public/billsBills (CC BY 4.0)
MOD-11GET/public/bills/{id}/resultsΑποτελέσματα (public)
MOD-11GET/public/vaa/partiesParteien (public)
MOD-24GET/public/cplmCPLM — Πολιτικός Καθρέφτης (X/Y)
MOD-24GET/public/cplm/historyCPLM Ιστορικά Snapshots
MOD-24GET/public/representationΑντιπροσωπευτικότητα Βουλής
MOD-11POST/public/keys/generateAPI Key (kein Konto nötig)
MOD-11GET/public/keys/statusAPI Key Status
MOD-12GET/mp/partiesΚόμματα με Παρλαμεντική Παρουσία
MOD-12GET/mp/rankingRanking Σύγκλισης με Πολίτες
MOD-12GET/mp/compare/{abbr}Κόμμα vs Πλειοψηφία Πολιτών
MOD-12GET/mp/bill/{id}Κομματικές Ψήφοι για Bill
MOD-12GET/mp/infoMP Comparison Docs
MOD-14GET/export/infoExport Endpoint Docs
MOD-14GET/export/bills.csvBills + Αποτελέσματα CSV
MOD-14GET/export/results.jsonΑποτελέσματα JSON
MOD-14GET/export/divergence.csvDivergence Ranking CSV
MOD-14GET/export/parties.jsonΚόμματα JSON
MOD-15GET/admin/dashboardAdmin Dashboard
MOD-15GET/admin/billsAdmin Bills Liste
MOD-15POST/admin/billsΝέο Bill δημιουργία
MOD-15PATCH/admin/bills/{id}Bill ενημέρωση
MOD-15POST/admin/bills/{id}/reviewAI Summary Review
MOD-15POST/admin/bills/{id}/party-votesΚομματικές Ψήφοι setzen
MOD-15GET/admin/statsAdmin Στατιστικά
MOD-15POST/notifications/test/publishTest Event publish
MOD-16GET/periferia13 Περιφέρειες
MOD-16GET/periferia/{id}/dimosΔήμοι Περιφέρειας
MOD-16GET/decisionsΑποφάσεις (φίλτρο)
MOD-21GET/municipal/{id}/decisionsDiavgeia Αποφάσεις Δήμου
MOD-21GET/regions/{id}/decisionsDiavgeia Αποφάσεις Περιφέρειας
MOD-21POST/admin/diavgeia/scrapeManual Scrape (Admin)
MOD-21POST/admin/diavgeia/refresh-orgs-cacheOrg Cache Refresh (Admin)
MOD-21GET/scraper/jobsScraper Job Status (Redis)
MOD-21GET/consensus/representationΣυγκεντρωτικά αποτελέσματα Διαύγειας ανά γεωγραφικό επίπεδο
MOD-22POST/agent/askRAG Agent — Ερωτήσεις και απαντήσεις πολιτών (5 req/min)
MOD-22GET/bills/{id}/summaryΠερίληψη νομοσχεδίου με AI (Redis cache 7d)
MOD-22POST/admin/logs/explainΑνάλυση αρχείων καταγραφής με AI (Admin)
MOD-22POST/admin/scraper/heal-statusAuto-Healing Status (Admin)
MOD-19POST/newsletter/subscribeNewsletter Εγγραφή
MOD-19GET/newsletter/statsNewsletter Στατιστικά
MOD-20POST/notify/registerPush Token Εγγραφή
MOD-25GET/politicians/Λίστα εκπροσώπων που ενεργοποίησαν την αξιολόγηση
MOD-25GET/politicians/{ada_number}/questionsΕρωτήσεις αξιολόγησης
MOD-25POST/politicians/{ada_number}/evaluateΥποβολή αξιολόγησης (-5 έως +5 ανά ερώτηση, Ed25519 signed)
MOD-25GET/politicians/{ada_number}/my-evaluationΗ αξιολόγησή μου
MOD-25GET/politicians/{ada_number}/scoresΔημόσια αποτελέσματα αξιολόγησης
MOD-25POST/rep/enable-evaluationΣυγκατάθεση εκπροσώπου για αξιολόγηση (εκπρόσωπος app)
MOD-25GET/rep/my-scoresΑποτελέσματα αξιολόγησης εκπροσώπου (εκπρόσωπος app)

Παράδειγμα

# Cast a vote. The server looks up the public key by nullifier_hash; # the server does not store the private key. # BILL_ID id of a bill from GET /bills # NULLIFIER_HASH 64-hex value returned by POST /identity/verify # SIGNATURE_HEX Ed25519 signature over "$BILL_ID:YES:$NULLIFIER_HASH" curl -X POST https://api.ekklesia.gr/api/v1/vote \ -H "Content-Type: application/json" \ -d '{ "bill_id": "'"$BILL_ID"'", "vote": "YES", "nullifier_hash": "'"$NULLIFIER_HASH"'", "signature_hex": "'"$SIGNATURE_HEX"'" }'