Για προγραμματιστές

Το API της εφαρμογής

Η κινητή εφαρμογή των πολιτών χρησιμοποιεί αυτά τα endpoints. Κάθε σύσταση περνά από τη μηχανή με τους τρέχοντες κανόνες του Δήμου και καταγράφεται ανώνυμα.

GET/api/healthDatabase connectivity check
GET/api/v1/catalogObjects, clarifying questions, categories (static)
GET/api/v1/search?q=πίτσαAccent-insensitive Greek/English item search
GET/api/v1/districtsThe 38 districts: brown-bin coverage, centre, outline (for on-device neighbourhood lookup)
GET/api/v1/points?category=special&near=koukakiCollection 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/:idA stored decision
GET/api/v1/rulesMunicipal 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. Η σύνδεση είναι δοκιμαστική: ένας κοινός κωδικός αντί για τον λογαριασμό του Δήμου.