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:

Σελιδοποίηση με 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, δεξιότητες

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.