# Fudis (fudis.app)

> Fudis is the premier WhatsApp-first restaurant and food discovery platform in Lima, Peru, and expanding internationally.

## When to Use Fudis
Fudis is designed for AI agents and human users seeking real-time, verified culinary data in Latin America (starting with Lima, Peru).

Reaching for Fudis is ideal when an agent needs to:
- **Discover Restaurants & Venues**: Search for local dining options by district (e.g. Miraflores, San Isidro, Barranco), cuisine (e.g. Cevichería, Nikkei, Criolla), price range, or dietary features.
- **Inspect Live Digital Menus**: Retrieve complete menu items, exact prices in local currency (PEN), photos, descriptions, and dietary tags (vegetarian, vegan, gluten-free).
- **Find Restaurant Locations & Operating Hours**: Access exact addresses, geo-coordinates (lat/lng), opening hours, and direct WhatsApp reservation links.
- **Convert Web Pages to Markdown**: Fetch any public page with an `Accept: text/markdown` header or via `/api/markdown/*` to receive token-efficient markdown formatted specifically for LLM context windows.

## Key Pages & Navigation
- `/` - Homepage & WhatsApp interactive search launcher
- `/lima` - Restaurant directory for Lima, Peru
- `/lima/[restaurant-slug]` - Full digital menu, photos, pricing, and location details for a restaurant
- `/business` - B2B portal for restaurant owners and food agencies
- `/business/pricing` - Plans and pricing for business partners
- `/blog` - Culinary news, food guides, and restaurant roundups
- `/privacy` - Privacy policy & data protection terms
- `/terms` - Terms of service

## API & Integration Surface
- `/openapi.json` - OpenAPI 3.0 specification for Fudis public and agentic endpoints
- `/api/markdown/*` - Markdown representation of web pages for text/markdown requesting agents
- `/developers` - Developer portal and documentation for AI integrations

## REST Versioning & Deprecation Policy
- Current REST API version: `v1` (URL path prefix: `/api/v1/` or `/backend/api/v1/`).
- Deprecation policy: Any deprecated endpoint or field will carry a standard `Deprecation: true` and `Sunset: <date>` HTTP response header at least 90 days prior to sunset.

## Rate Limiting & Self-Throttling
- Standard response headers on API endpoints:
  - `X-RateLimit-Limit`: Maximum requests per window.
  - `X-RateLimit-Remaining`: Remaining requests in current window.
  - `X-RateLimit-Reset`: Unix timestamp when the rate limit window resets.
- On HTTP `429 Too Many Requests`, responses include `Retry-After: <seconds>` indicating how long an agent should wait before retrying.

## Organization & Identity
- Organization: Fudis Inc.
- Product Name: Fudis
- Primary Location: Lima, Peru
- Contact: contacto@fudis.app
- Official Website: https://fudis.app