---
title: "Τεκμηρίωση API | Upstairs Digital Marketing Agency"
url: "https://upstairs.gr/docs/"
lang: "el"
description: "Τεκμηρίωση του MCP, του REST API και του OpenAPI για το upstairs.gr. Η προσφορά δεν στέλνεται από τα εργαλεία."
---

id="main" data-pagefind-body class="astro-z4jru4n3">
-   [Αρχική](/)
-  › Τεκμηρίωση API

       DEVELOPERS / API

# Τεκμηρίωση για προγραμματιστές.

 Δημόσια, μόνο για ανάγνωση. Τα εργαλεία δείχνουν όσα είναι ήδη δημοσιευμένα στο upstairs.gr. Δεν στέλνουν email και δεν υποβάλλουν τη φόρμα αντί για τον άνθρωπο.

## MCP

 Streamable HTTP JSON-RPC στο [POST /mcp](/mcp). Η κάρτα είναι [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json) και η διαφήμιση [/.well-known/mcp.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](/api). Έκδοση 1:

- [/api/v1/services](/api/v1/services) και /api/v1/services/{slug}
- [/api/v1/posts](/api/v1/posts) και /api/v1/posts/{slug}
- [/api/v1/glossary](/api/v1/glossary)
- [/api/v1/contact](/api/v1/contact)
- [/api/v1/offers](/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](/openapi.json), επίσης [/api/v1/openapi.json](/api/v1/openapi.json) και [/.well-known/openapi.json](/.well-known/openapi.json). Ο παλαιότερος υπολογιστής μένει στο [/api/openapi.json](/api/openapi.json).
- [/llms.txt](/llms.txt) και [/llms-full.txt](/llms-full.txt)
- Markdown twin: [/index.md](/index.md) για την αρχική, αλλιώς /path.md, ή Accept: text/markdown
- [Agent Skills](/.well-known/agent-skills/index.json) και [κάρτα A2A](/.well-known/agent-card.json)
- [/agents.md](/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.

Η προσφορά δεν καταχωρείται από το MCP, από το markdown ή από το llms.txt. Δεν στέλνεται email.
Ο ενδιαφερόμενος διαλέγει έναν από τους παρακάτω τρόπους:
- WhatsApp: +30 698 045 3430 (https://wa.me/306980453430). Το μήνυμα ανοίγει προσυμπληρωμένο και δεν στέλνεται μόνο του.
- Τηλέφωνο: +30 210 4408777 (+302104408777), Δευτέρα - Παρασκευή 09:00 - 21:00.
- Email: info@upstairs.gr.
- Φόρμα επικοινωνίας: https://upstairs.gr/contact/.
- Φόρμα «Πάρε Προσφορά»: https://upstairs.gr/#fformm.
Η φόρμα χρειάζεται τηλέφωνο και email ή ονοματεπώνυμο, και έλεγχο ασφαλείας όταν είναι ενεργός. Δεν υπάρχει παράκαμψη από αυτό το εργαλείο.

