Inicio rápido
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
El modelo conceptual: apps, locales, conexiones y quién es responsable de qué.
Comience con la tarea que está realizando
Reciba y decida pedidos
Reciba webhooks
order.notification y gestione cada pedido con las llamadas accept, deny, ready y complete.Publique un menú
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
Verifique firmas HMAC, deduplique entregas y repita eventos desde el registro de eventos.
Explore todos los endpoints
Esquemas de solicitud y respuesta para autenticación, locales, conexiones, menú, pedidos y webhooks.
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 credencialBearer. 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:
- Dos entornos: el sandbox en
https://api.staging.maple.inc/v1para desarrollo, y producción enhttps://api.maple.inc/v1. Están totalmente aislados. Vea Entornos. - Autenticación con clave de API: envíe su clave (
mpk_test_…/mpk_live_…) como token Bearer. Vea Autenticación. - 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.
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 para recibir una invitación y
luego siga el Inicio rápido. Crear una clave no otorga acceso a locales ni activa la
producción.