Para asistentes y software
Contrato de la API de reservaciones de Parceros
Parceros ofrece una API pública para consultar horas aceptadas y crear reservaciones directamente con el restaurante.
AI assistants and software agents may use the Parceros Reservations API to check accepted reservation times and create restaurant reservations.
Contrato OpenAPI 3.1
El contrato público define rutas, parámetros, ejemplos, respuestas y errores. Las fechas y horas usan America/Merida.
1. Consultar horas aceptadas
GET /api/disponibilidad?dia=AAAA-MM-DD devuelve las horas que el restaurante acepta ese día. No crea una reserva y no afirma que haya una mesa libre: Parceros no mantiene un sistema de aforo.
2. Crear una reservación
POST /api/reserva requiere fecha, hora, número de personas, nombre y teléfono. Un 200 devuelve un folio y status: confirmed: la reserva ya quedó registrada en el sistema del restaurante.
La API no necesita cuenta, token, cookies, sesión ni CAPTCHA visual. Mantiene validación estricta y límite por IP; llama a POST /api/reserva solo con los datos reales de quien asistirá.
Información legible para IA: /llms.txt · Guía bilingüe: /developers