Για προγραμματιστές
Το API της εφαρμογής
Η κινητή εφαρμογή των πολιτών χρησιμοποιεί αυτά τα endpoints. Κάθε σύσταση περνά από τη μηχανή με τους τρέχοντες κανόνες του Δήμου και καταγράφεται ανώνυμα.
GET | /api/health | Database connectivity check |
GET | /api/v1/catalog | Objects, clarifying questions, categories (static) |
GET | /api/v1/search?q=πίτσα | Accent-insensitive Greek/English item search |
GET | /api/v1/districts | The 38 districts: brown-bin coverage, centre, outline (for on-device neighbourhood lookup) |
GET | /api/v1/points?category=special&near=koukaki | Collection points, nearest to a neighbourhood first (no coordinates accepted) |
POST | /api/v1/decisions | { objectId, answers?, districtId?, deviceId?, via? } → explained decision, nearby points, and any neighbourhood story it unlocked. Neighbourhood only, never coordinates. |
GET | /api/v1/decisions/:id | A stored decision |
GET | /api/v1/rules | Municipal rule registry and on/off state |
GET | /api/v1/leaderboard?period=week&district=…&deviceId=… | Top 20 scanners (nicknames only), your rank, top neighbourhoods. Max 20 scans a day count. |
GET | /api/v1/stories?district=…&deviceId=… | Neighbourhood stories: unlocked after 1, 5, 15, 30, 50 scans there (the reward) |
GET/POST | /api/v1/profile | { deviceId, nickname } → leaderboard nickname (empty clears it) |
POST | /api/v1/bin-reports | { pointId, kind: full | overflowing | damaged, deviceId } → alert on the dashboard |
POST | /api/v1/service-requests | { districtId, deviceId? } → request a brown bin |
Σύνδεσε το RecycleIQ στο AI του Δήμου (MCP)
Ο Δήμος βάζει το RecycleIQ στο AI που ήδη χρησιμοποιεί (Claude, ChatGPT, Claude Code) ως connector. Έχει όλα τα εργαλεία του βοηθού του dashboard: αναλύσεις, χάρτες, αναφορές, κανόνες και ενέργειες.
- Διεύθυνση
- https://recycleiq.eu/api/mcp
- Σύνδεση
- OAuth. Δοκιμαστικός κωδικός:
test123 - Claude
- Ρυθμίσεις → Connectors → Add custom connector → η διεύθυνση → Connect → κωδικός.
- Claude Code
- claude mcp add --transport http recycleiq https://recycleiq.eu/api/mcp
- Επιλογές
?lang=enαγγλικά ·?bins=osmπραγματικοί κάδοι
Οδηγός και λίστα εργαλείων: docs/MCP.md. Η σύνδεση είναι δοκιμαστική: ένας κοινός κωδικός αντί για τον λογαριασμό του Δήμου.