> ## 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.

<Columns cols={2}>
  <Card title="Inicio rápido" icon="rocket" href="/es/developer-api/quickstart">
    Inicie sesión, cree su propia clave y encuentre su primera solicitud a la API y una entrega de prueba firmada.
  </Card>

  <Card title="Cómo funciona Maple" icon="diagram-project" href="/es/developer-api/how-maple-works">
    El modelo conceptual: apps, locales, conexiones y quién es responsable de qué.
  </Card>
</Columns>

## Comience con la tarea que está realizando

<Columns cols={2}>
  <Card title="Reciba y decida pedidos" icon="receipt" href="/es/developer-api/guides/receive-orders">
    Reciba webhooks `order.notification` y gestione cada pedido con las llamadas accept, deny, ready y complete.
  </Card>

  <Card title="Publique un menú" icon="book-open" href="/es/developer-api/guides/publish-menu">
    Envíe el menú completo de un local como un solo documento JSON identificado con sus propios IDs estables, y léalo de vuelta.
  </Card>

  <Card title="Maneje webhooks" icon="bell" href="/es/developer-api/concepts/webhooks">
    Verifique firmas HMAC, deduplique entregas y repita eventos desde el registro de eventos.
  </Card>

  <Card title="Explore todos los endpoints" icon="code" href="/es/developer-api/api-reference">
    Esquemas de solicitud y respuesta para autenticación, locales, conexiones, menú, pedidos y webhooks.
  </Card>
</Columns>

## 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](/es/developer-api/concepts/environments):

```bash theme={null}
# 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](/es/developer-api/concepts/environments).
* **Autenticación con clave de API:** envíe su clave (`mpk_test_…` / `mpk_live_…`) como token Bearer. Vea [Autenticación](/es/developer-api/concepts/authentication).
* **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](/es/developer-api/quickstart). Crear una clave no otorga acceso a locales ni activa la
  producción.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.