← Torna alla home

API e agenti

Fralli & Giovi espone una API pubblica in sola lettura con le informazioni del matrimonio. Nessuna autenticazione, risposte JSON. La specifica è in /openapi.json (OpenAPI 3.1) e nel catalogo /.well-known/api-catalog.

Endpoint

  • GET /api/v1/info — Dati del matrimonio (data, location, dress code, contatti)
  • GET /api/v1/schedule — Programma del weekend
  • GET /api/v1/travel — Come arrivare
  • GET /api/v1/accommodations — Alloggi consigliati
  • GET /api/v1/pages — Pagine del sito

Esempio

curl -s https://fralliegiovi.com/api/v1/schedule
curl -s -H "Accept: text/markdown" https://fralliegiovi.com/

Autenticazione e rate limit

Nessuna chiave richiesta. Limite di 60 richieste al minuto per IP: ogni risposta include gli header RateLimit-Policy e RateLimit; oltre il limite si riceve 429 con Retry-After.

Errori

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

MCP

Server MCP Streamable HTTP su POST https://fralliegiovi.com/mcp (JSON-RPC 2.0). Tool: get_wedding_info, get_schedule, get_travel_info, list_accommodations, list_pages. Risorse: fralliegiovi://info, fralliegiovi://schedule, fralliegiovi://home.md. Server card: /.well-known/mcp/server-card.json.

curl -s -X POST https://fralliegiovi.com/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_schedule"}}'

Markdown

Le pagine principali rispondono in Markdown con l'header Accept: text/markdown. La guida per agenti è in /llms.txt.