API και MCP
Οι άδειες δόμησης από τη Διαύγεια (e-Άδειες) ως δομημένα δεδομένα, μέσω REST API ή MCP. Ίδια δεδομένα και ίδια δικαιώματα με την εφαρμογή: οι νομοί και οι δυνατότητες του πλάνου σου ισχύουν και εδώ.
Πρόσβαση
Το API και το MCP είναι διαθέσιμα στα πλάνα συνδρομής. Το κλειδί το φτιάχνει ο διαχειριστής του οργανισμού στις Ρυθμίσεις → API, με πρόσβαση «μόνο ανάγνωση» ή «ανάγνωση και εγγραφή». Το κλειδί στέλνεται πάντα στο header, ποτέ στο URL.
REST API
JSON, σελιδοποίηση με cursor (έως 50 γραμμές ανά σελίδα και έως 1.000 εγγραφές ανά αναζήτηση — για περισσότερα στένεψε τα φίλτρα). Σφάλματα: { error: { code, message } }.
curl -sG "https://bouldoza.gr/api/v1/permits" \ -H "Authorization: Bearer $BOULDOZA_KEY" \ --data-urlencode "municipality=Γλυφάδας" \ --data-urlencode "q=πισίνα" \ --data-urlencode "limit=10"
Ανάγνωση
| Μέθοδος | Διαδρομή | Τι κάνει |
|---|---|---|
| GET | /me | Πλάνο, νομοί του πλάνου, υπόλοιπα του μήνα, τι επιτρέπεται. |
| GET | /regions | Νομοί και δήμοι όπως γράφονται στη βάση. |
| GET | /permits | Αναζήτηση πράξεων με φίλτρα (είδος, περιοχή, περίοδος, μεγέθη, πισίνα, χρήσεις, ελεύθερο κείμενο q). |
| GET | /permits/{ada} | Καρτέλα πράξης. |
| GET | /projects/{id} | Έργο: όλες οι πράξεις στο ίδιο ακίνητο. |
| GET | /engineers | Μηχανικοί κατά δραστηριότητα (συνδρομητές). |
| GET | /engineers/{id} | Προφίλ μηχανικού (συνδρομητές). |
| GET | /companies | Εταιρείες ως ιδιοκτήτες έργου ή μελετητές (συνδρομητές). |
| GET | /companies/{id} | Προφίλ εταιρείας (συνδρομητές). |
| GET | /stats | Συγκεντρωτικά ανά είδος, μήνα και δήμο. |
Λίστες, ειδοποιήσεις και παρακολουθήσεις
Οι αλλαγές γίνονται ως ο χρήστης που έφτιαξε το κλειδί, με τα ίδια όρια του πλάνου όπως στην εφαρμογή, και καταγράφονται.
| Μέθοδος | Διαδρομή | Τι κάνει |
|---|---|---|
| GET · POST | /lists | Λίστες του οργανισμού · νέα λίστα. |
| GET | /lists/{id} | Λίστα με τις εγγραφές της. |
| POST · DELETE | /lists/{id}/items | Προσθήκη / αφαίρεση πράξεων (έως 100 ΑΔΑ). |
| GET · POST | /alerts | Ειδοποιήσεις για νέες πράξεις · νέα ειδοποίηση. |
| GET · PATCH · DELETE | /alerts/{id} | Μία ειδοποίηση: αλλαγή φίλτρων, συχνότητας, ώρας ή διαγραφή. |
| GET · POST · DELETE | /follows | Παρακολούθηση μηχανικού, έργου ή δήμου. |
Προδιαγραφή OpenAPI · https://bouldoza.gr/api/v1
Claude και MCP
Ο MCP server δίνει στο Claude εργαλεία για αναζήτηση αδειών, έργων, μηχανικών, εταιρειών και στατιστικών, και — με πρόσβαση εγγραφής — για λίστες, ειδοποιήσεις και παρακολουθήσεις. Πριν από κάθε διαγραφή το Claude ζητά επιβεβαίωση.
https://bouldoza.gr/api/mcp
- Claude.ai: Ρυθμίσεις → Connectors → Add custom connector με το URL του server. Συνδέεσαι στο Bouldoza, διαλέγεις οργανισμό και πρόσβαση — χωρίς κλειδί. Η σύνδεση ανακαλείται από τις Ρυθμίσεις → API.
- Claude Code / Claude Desktop: με κλειδί API στο header Authorization.
claude mcp add --transport http bouldoza https://bouldoza.gr/api/mcp \ --header "Authorization: Bearer bz_live_…"
Τα δεδομένα
Μόνο κανονικές πράξεις (χωρίς διπλές αναρτήσεις και ανακληθείσες). Πεδίο που δεν εξήχθη με σιγουριά επιστρέφει null. Ο ιδιοκτήτης εμφανίζεται μόνο όταν είναι εταιρεία.