> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fooddelivery.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Bienvenido a la API pública de FoodDelivery

FoodDelivery es la plataforma de venta directa para restaurantes en Chile:
carta digital, pagos online, delivery al mejor precio y fidelización, sin
comisiones por pedido. Con nuestra API puedes integrar tus pedidos, tu menú y
tu inventario con cualquier sistema externo: POS, ERP, contabilidad o tus
propios dashboards.

## ¿Qué puedes hacer con la API?

<CardGroup cols={2}>
  <Card title="Pedidos" icon="receipt">
    Consulta los pedidos de tus sucursales — y créalos desde tu propia
    página, con cotización de delivery y pago online incluidos. Ver la guía
    [Tu propia tienda](/tienda-propia).
  </Card>

  <Card title="Menú e inventario" icon="utensils">
    Lee tu carta completa (categorías, productos, modificadores y precios) y
    sincroniza el stock por sucursal desde tu ERP.
  </Card>

  <Card title="Locales" icon="shop">
    Consulta si cada sucursal está abierta y ábrela o ciérrala al instante
    desde tus sistemas.
  </Card>

  <Card title="Webhooks" icon="bolt">
    Próximamente: notificaciones HTTP cuando entra un pedido nuevo o cambia
    de estado. Ver [Webhooks](/webhooks).
  </Card>
</CardGroup>

## Principios de la API

* **REST + JSON**: endpoints predecibles bajo `https://app.fooddelivery.cl/api/v1`.
* **Lectura y escritura con permisos por llave**: los `GET` funcionan con
  cualquier llave; crear pedidos, cambiar estados, abrir/cerrar local y
  actualizar stock requieren una llave con **escritura** habilitada. Ver
  [Autenticación](/autenticacion).
* **Precios siempre server-side**: al crear pedidos, los montos se calculan
  desde tu catálogo; la API nunca acepta precios del integrador.
* **Una API key por restaurante**: cada llave da acceso únicamente a los datos
  del restaurante que la generó.
* **Montos en CLP** sin decimales; fechas en formato ISO 8601.

## Próximos pasos

<Steps>
  <Step title="Consigue tu API key">
    Sigue la guía [Paso a Paso](/paso-a-paso) para generar tu llave desde el
    panel de administración (Integraciones → API pública).
  </Step>

  <Step title="Haz tu primera llamada">
    Prueba `GET /api/v1/orders` con el playground integrado en la pestaña
    **API Pedidos y Menú**.
  </Step>

  <Step title="Maneja los errores">
    Revisa el formato uniforme de [errores](/errores) y los
    [límites de uso](/autenticacion#límites-de-uso).
  </Step>
</Steps>