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

# Developer API

> Conecte su POS o plataforma con Maple: reciba y decida pedidos, publique menús y suscríbase a webhooks firmados.

La Developer API de Maple conecta su POS o plataforma con los locales de Maple aprobados. Reciba y decida pedidos, publique menús o administre reservas usando los alcances (scopes) y las capacidades de local aprobados para su integración.

No hay ningún SDK que instalar. En las integraciones de pedidos, Maple se encarga del procesamiento de los pagos de los clientes y entrega los pedidos con los totales ya calculados. Use la consola de desarrolladores para administrar sus claves, webhooks y diagnósticos.

- [Inicio rápido](https://docs.maple.inc/es/developer-api/quickstart.md): Inicie sesión, cree su propia clave y encuentre su primera solicitud a la API y una entrega de prueba firmada.
- [Cómo funciona Maple](https://docs.maple.inc/es/developer-api/how-maple-works.md): El modelo conceptual: apps, locales, conexiones y quién es responsable de qué.

## Comience con la tarea que está realizando

- [Reciba y decida pedidos](https://docs.maple.inc/es/developer-api/guides/receive-orders.md): Reciba webhooks order.notification y gestione cada pedido con las llamadas accept, deny, ready y complete.
- [Publique un menú](https://docs.maple.inc/es/developer-api/guides/publish-menu.md): Envíe el menú completo de un local como un solo documento JSON identificado con sus propios IDs estables, y léalo de vuelta.
- [Maneje webhooks](https://docs.maple.inc/es/developer-api/concepts/webhooks.md): Verifique firmas HMAC, deduplique entregas y repita eventos desde el registro de eventos.
- [Explore todos los endpoints](https://docs.maple.inc/es/developer-api/api-reference.md): Esquemas de solicitud y respuesta para locales, conexiones, menú, zonas de entrega, pedidos, webhooks, reservas, lista de espera y comentarios (feedback).

## Lo que nunca tendrá que construir

Las integraciones con restaurantes suelen ser dolorosas porque heredan problemas que no son suyos. Con Maple, usted no tiene que lidiar con esto:

- **Sin integración de pagos.** Maple crea y administra el enlace de pago. Usted nunca toca una tarjeta ni asume el alcance de PCI.
- **Sin motor de precios.** Maple calcula cada total que ve el cliente. Usted lee centavos enteros.
- **Sin sondeo.** Los pedidos se envían a su webhook; un registro y endpoints de repetición cubren la recuperación.
- **Sin SDK obligatorio.** Es una API REST que puede llamar desde cualquier lenguaje.
- **Sin adivinar en producción.** Primero desarrolla con datos de prueba aislados; el acceso en vivo se habilita una vez que su integración es aprobada.

## La forma de la API

Cada solicitud autenticada lleva una credencial `Bearer`. Desarrolle en el sandbox preparado y luego obtenga una aprobación de producción por separado y configure la app, los accesos, la clave y los endpoints de producción. Vea [Entornos](https://docs.maple.inc/es/developer-api/concepts/environments.md):

```bash
# Sandbox — build and test here
curl https://api.staging.maple.inc/v1/me \
  -H "Authorization: Bearer mpk_test_..."
```

- **Dos entornos:** el sandbox en `https://api.staging.maple.inc/v1` para desarrollo, y producción en `https://api.maple.inc/v1`. Están totalmente aislados. Vea [Entornos](https://docs.maple.inc/es/developer-api/concepts/environments.md).
- **Autenticación con clave de API:** envíe su clave (`mpk_test_…` / `mpk_live_…`) como token Bearer. Vea [Autenticación](https://docs.maple.inc/es/developer-api/concepts/authentication.md).
- **Acceso por alcances:** su app solo tiene los permisos que necesita (`orders:read`, `menus:write`, `webhooks:write`, etc.).
- **Recursos predecibles:** IDs opacos, dinero en centavos de USD enteros, sobres de eventos al estilo de Stripe y cuerpos de error consistentes.

> [!NOTE]
>
> El acceso es primero por invitación a socios. Maple aprueba su app y prepara su sandbox y los accesos a locales; los miembros de su organización inician sesión en **Developers** para crear claves, administrar webhooks e inspeccionar los diagnósticos de solicitudes y entregas. [Contáctenos](https://maple.inc/get-started) para recibir una invitación y luego siga el [Inicio rápido](https://docs.maple.inc/es/developer-api/quickstart.md). Crear una clave no otorga acceso a locales ni activa la producción.