GuestSuite API e sviluppatori

Panoramica

GuestSuite offre un'API pubblica read-only con le informazioni sul prodotto: descrizione e funzionalita', prezzo mensile per numero di strutture ed elenco delle pagine e delle guide per host. Non espone dati di utenti, prenotazioni o ospiti. La specifica completa e' in /openapi.json (OpenAPI 3.1), il catalogo in /.well-known/api-catalog.

Endpoint

  • GET /api/v1/info informazioni, stato e contatti
  • GET /api/v1/pricing?properties=3 prezzo mensile per 1-100 strutture
  • GET /api/v1/pages?type=blog&limit=10 pagine pubbliche (all, static, blog, solution)
curl https://guestsuite.app/api/v1/info
curl "https://guestsuite.app/api/v1/pricing?properties=3"
curl "https://guestsuite.app/api/v1/pages?type=blog&limit=5"

Autenticazione e rate limit

Nessuna autenticazione. Il limite e' di 60 richieste al minuto per IP, comunicato con gli header IETF RateLimit-Policy e RateLimit. Oltre il limite la risposta e' 429 con Retry-After.

Errori

Gli errori sotto /api/ usano application/problem+json (RFC 9457) con i campi type, title, status, detail, code e resolution.

{
  "type": "https://guestsuite.app/docs#errors",
  "title": "Bad Request",
  "status": 400,
  "detail": "Il parametro \"properties\" deve essere un intero tra 1 e 100.",
  "code": "invalid_parameter",
  "resolution": "Ripeti la richiesta con ?properties=<numero di strutture>"
}

Server MCP

Gli stessi dati sono disponibili come server MCP (Streamable HTTP, JSON-RPC 2.0, senza autenticazione) su https://guestsuite.app/mcp, con i tool read-only get_guestsuite_info, get_pricing e list_pages e due risorse JSON. Manifest in /.well-known/mcp/server-card.json e /server.json.

claude mcp add --transport http guestsuite https://guestsuite.app/mcp

curl -X POST https://guestsuite.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_pricing","arguments":{"properties":2}}}'

Markdown per agenti

Ogni pagina pubblica e' disponibile in Markdown inviando Accept: text/markdown. Il riepilogo per modelli linguistici e' in /llms.txt. Per domande scrivi dalla pagina Contatti.