🔗 Base URL: http://localhost:8000 · Swagger: http://localhost:8000/docs
MOD-01 — Identity
| Method | Endpoint | Περιγραφή |
| POST | /api/v1/identity/verify | SMS → Ed25519 Keypair |
| POST | /api/v1/identity/revoke | Ακύρωση κλειδιού |
| POST | /api/v1/identity/status | Έλεγχος status |
// POST /api/v1/identity/verify
{ "phone_number": "+306912345678", "region": "REG_ATTICA" }
// Response — ⚠️ private_key εμφανίζεται ΜΙΑ ΦΟΡΑ
{ "success": true, "private_key_hex": "...", "public_key_hex": "...", "nullifier_hash": "..." }
MOD-02 — VAA
| Method | Endpoint | Περιγραφή |
| GET | /api/v1/vaa/statements | 15 Θέσεις |
| GET | /api/v1/vaa/parties | 8 Κόμματα |
| POST | /api/v1/vaa/match | Matching |
// POST /api/v1/vaa/match
{ "answers": { "1": 1, "2": -1, "3": 0 } } // 1=Υπέρ, -1=Κατά, 0=Ουδέτερο
MOD-03 — Parliament
| Method | Endpoint | Περιγραφή |
| GET | /api/v1/bills | Νομοσχέδια |
| GET | /api/v1/bills/trending | Relevance Score |
| GET | /api/v1/bills/{id} | Λεπτομέρειες |
| POST | /api/v1/bills/{id}/transition | Lifecycle |
| POST | /api/v1/bills/admin/create | Νέο bill |
MOD-04 — CitizenVote
| Method | Endpoint | Περιγραφή |
| POST | /api/v1/vote | Ψήφος (Ed25519) |
| GET | /api/v1/vote/{id}/results | Αποτελέσματα |
| POST | /api/v1/vote/{id}/relevance | Up/Down Signal |
// POST /api/v1/vote
{ "nullifier_hash": "abc...64", "bill_id": "GR-2025-0001", "vote": "YES", "signature_hex": "def..." }
// GET /api/v1/vote/GR-2025-0001/results
{ "total_votes": 1247, "yes_percent": 34.2, "no_percent": 58.7,
"divergence": { "score": 0.587, "label_el": "Έντονη Απόκλιση" } }