← LA EXCELENTE
Developer & Agent Documentation

Developer Portal — La Excelente API

Bienvenido al portal de desarrolladores y agentes de La Excelente Pizzería Napolitana. Esta plataforma provee endpoints REST públicos, especificaciones OpenAPI 3.1 y servidores MCP (Model Context Protocol) para conectar asistentes virtuales, modelos de lenguaje y motores de búsqueda.

Autenticación y Niveles de Acceso

Nivel Público (Free Tier / Cero Fricción): Todos los endpoints de lectura (carta, precios, ubicación, horarios y delivery) son 100% públicos y no requieren clave de API (API Key) ni registro previo.

Límites de Peticiones (Rate Limits): Cada IP dispone de 100 peticiones por minuto. Los encabezados estándar RFC RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset se incluyen en cada respuesta (con Retry-After: 60 en caso de HTTP 429).

Endpoints REST Disponibles

GET /api/menu

Devuelve la carta completa estructurada por categorías (Antipastos, Pizzas Rojas, Pizzas Blancas, Ensaladas, Postres, Bebestibles) con nombres, precios en CLP, ingredientes y etiquetas dietéticas.

curl -s https://laexcelente.cl/api/menu | jq .

GET /api/restaurant

Retorna dirección física, coordenadas geográficas, horarios y enlaces oficiales de delivery.

curl -s https://laexcelente.cl/api/restaurant | jq .

GET /api/hours

Calcula dinámicamente si la pizzería está abierta en este momento en el huso horario de Santiago (America/Santiago) y entrega los turnos semanales.

curl -s https://laexcelente.cl/api/hours | jq .

GET /api/delivery

Entrega los enlaces directos a las tiendas oficiales en PedidosYa, Uber Eats, Rappi y WhatsApp.

curl -s https://laexcelente.cl/api/delivery | jq .

POST /api/order/whatsapp

Genera un mensaje preformateado y una URL de checkout directo por WhatsApp con los productos seleccionados y la dirección de despacho.

Integración MCP (Model Context Protocol)

Para integrar La Excelente como herramientas en Claude Desktop, ChatGPT u orquestadores agénticos, utiliza el manifest oficial:

https://laexcelente.cl/.well-known/mcp/manifest.json

Negociación de Formato Markdown (acceptmarkdown.com)

Si un agente solicita Accept: text/markdown, el servidor responde con contenido enriquecido en formato Markdown listo para ingesta de contexto por LLMs.

curl -H "Accept: text/markdown" https://laexcelente.cl/