DEVELOPERS / API
Τεκμηρίωση για προγραμματιστές.
Δημόσια, μόνο για ανάγνωση. Τα εργαλεία δείχνουν όσα είναι ήδη δημοσιευμένα στο upstairs.gr. Δεν στέλνουν email και δεν υποβάλλουν τη φόρμα αντί για τον άνθρωπο.
MCP
Streamable HTTP JSON-RPC στο POST /mcp. Η κάρτα είναι /.well-known/mcp/server-card.json και η διαφήμιση /.well-known/mcp.json.
Εργαλεία: list_services, get_service, list_posts, get_post, get_contact_info, request_quote. Όλα είναι read-only. Το request_quote επιστρέφει WhatsApp, τηλέφωνο, email και φόρμα.
REST API
Ευρετήριο: GET /api. Έκδοση 1:
/api/v1/servicesκαι/api/v1/services/{slug}/api/v1/postsκαι/api/v1/posts/{slug}/api/v1/glossary/api/v1/contact/api/v1/offers
Σελιδοποίηση με limit (1 έως 100, προεπιλογή 20) και cursor. Η επόμενη σελίδα είναι στο links.next και στην κεφαλίδα Link. Κάθε απάντηση έχει API-Version: 1 και κεφαλίδες RateLimit-* και X-RateLimit-*.
Τα σφάλματα 400, 404, 405, 422 και 429 είναι application/problem+json (RFC 9457) με type, title, status, detail, instance και code.
POST /api/v1/quote-requests με κεφαλίδα Idempotency-Key απαντά 202 και Location: /api/v1/jobs/{id}. Το ίδιο κλειδί και το ίδιο σώμα επιστρέφουν την ίδια εργασία. Διαφορετικό σώμα επιστρέφει 422. Δεν αποθηκεύεται το σώμα και δεν στέλνεται email.
OpenAPI, llms.txt, markdown, δεξιότητες
- OpenAPI 3.1, επίσης
/api/v1/openapi.jsonκαι/.well-known/openapi.json. Ο παλαιότερος υπολογιστής μένει στο/api/openapi.json. /llms.txtκαι/llms-full.txt- Markdown twin:
/index.mdγια την αρχική, αλλιώς/path.md, ήAccept: text/markdown - Agent Skills και κάρτα A2A
/agents.md
English
upstairs.gr exposes a read-only MCP server at POST /mcp, a read-only REST API under /api/v1/, and OpenAPI 3.1 at /openapi.json. request_quote and POST /api/v1/quote-requests tell a person how to use the contact form, WhatsApp +30 698 045 3430, or +30 210 4408777. They do not send email. Errors use RFC 9457 application/problem+json. Lists use limit and cursor. Every API response carries API-Version: 1 and rate-limit headers.
