{"openapi":"3.1.0","info":{"title":"cafe.cafe & tips.tips — Global AI Gastronomic Discovery & Reservation API","version":"1.2.0","description":"Public machine-readable API for AI assistants, search engines, and autonomous dining concierges to query live KDS-synced restaurant menus (with exact calories, protein, allergens, and wine pairings), inspect HoReCa benchmarks, and reserve tables."},"servers":[{"url":"https://cafe-cafe-59043686903.europe-west1.run.app"}],"paths":{"/api/public/ai-catalog":{"get":{"operationId":"searchLiveMenusAndVenues","summary":"Search live in-stock dishes and connected restaurants by query, city, protein, calories, or gluten-free diet","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Dish, ingredient, or wine pairing keyword (e.g. wagyu, matcha, salmon)"},{"name":"city","in":"query","schema":{"type":"string"},"description":"City or district filter (e.g. dubai, paris)"},{"name":"gf","in":"query","schema":{"type":"boolean"},"description":"Filter strictly gluten-free dishes"},{"name":"minProtein","in":"query","schema":{"type":"number"},"description":"Minimum protein in grams per portion"},{"name":"maxCalories","in":"query","schema":{"type":"number"},"description":"Maximum calories (kcal) per portion"}],"responses":{"200":{"description":"Filtered list of connected restaurants and live in-stock dishes"}}}},"/api/public/ai-index":{"get":{"operationId":"getGlobalSmartDiningIndex","summary":"Retrieve real-time Global Smart Table & Cashless Tipping Index benchmarks and venue directory","responses":{"200":{"description":"Aggregated platform economics and culinary nutrition benchmarks"}}}},"/api/public/ai-reserve":{"post":{"operationId":"createTableReservation","summary":"Book a restaurant table directly into the venue Hostess & KDS console","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["venueSlug","guestName","guestPhone"],"properties":{"venueSlug":{"type":"string","example":"atelier"},"dateStr":{"type":"string","example":"2026-12-31"},"timeStr":{"type":"string","example":"20:00"},"guestsCount":{"type":"integer","example":2},"zone":{"type":"string","example":"Library Hall"},"guestName":{"type":"string","example":"Alex Mercer"},"guestPhone":{"type":"string","example":"+971501234567"},"guestComment":{"type":"string","example":"Window table if available"}}}}}},"responses":{"201":{"description":"Table reservation confirmed and synced to restaurant KDS"}}}}}}